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Borland's No-Nonsense License Statementl 


This software is protected by both United States copyright law and international treaty provisions. 
Therefore, you must treat this software ws je g book with the following single exception. Borland 
International authorizes you to make archival copies of the software for the sole purpose of backing- 
up our software and protecting your investment from loss. 


By saying, justlike abook.” Borland means, for example, that this software may be used by any number 
of people and may be freely moved from one computer location to another, so long as there is no 
possibility of it being used at one location while it's being used at another. Just like a book that cant 
be read by two different people in two different places at the same time, neither can the software be 
used by two different people in two different places at the same time (unless, of course, Borland's 
copyright has been violated). 


Programs that you write and compile using the Turbo C language compiler may be used, given away 
or sold without additional license or fees, as long as all copies of such programs bear a copyright notice. 
By “copyright notice" we mean either your own copyright notice or, if you prefer, the statement 
“Created using TurboC, Copyright @ Borland 1987, 1988."Included in the Turbo て diskettes are several 
support files that contain encoded hardware and font information used by the standard graphics library 
(GRAPHICS.LIB). These files, which can be listed by typing DIR *.CHR and DIR *.BGL are proprietary 
to Borland International. You may use these files with the programs you create with Turbo C for your 
own personal use. In addition, to the extent the programs you write and compile using the Turbo て 
language compiler make use of these support files, you may distribute these support files in combination 
with such programs, provided that you do not use, give away, or sell the support files separately, and 
all copies of such programs bear a copyright notice. 


The sample programs included on the Turbo C diskettes provide a demonstration of how to use the 
various features of Turbo C. They are intended for educational purposes only. Borland International 
grants you (the registered owner of Turbo C) the right to edit or modify these sample programs for 
your own use, but you may not give away or sell them, alone or as part of any program, in executable, 
object or source code form. You may, however, incorporate miscellaneous sample program routines into 
your programs, as long as your resulting programs do not substantially duplicate all or part of a sample 
Program in appearance or functionality and all copies of such programs bear a copyright notice. 


Limited Warranty 

With respect to the physical diskette and physical documentation enclosed herein, Borland 
International Inc. (“Borland") warrants the same tobe free of defects in materials and workmanship for 
a period of 60 days from the date of purchase. In the event of notification within the warranty period 
of defects in material or workmanship, Borland will replace the defective diskette or documentation.If 
you need to return a product, call the Borland Customer Service Department to obtain a return 
authorization number. The remedy for breach of this warranty shall be limited toreplacementand shall 
not encompass any other damages, including but not limited to loss of profit, and special, incidental 
consequential, or other similar claims. 


Borland International Inc. specifically disclaims all other warranties, expressed or implied, including 
but not limited to implied warranties of merchantabihity and fitness for a particular purpose with 
respect to defects in the diskette and documentation, and the program license granted herein in 
Particular, and without limiting operation of the program license with respect to any particular 
application, use, or purpose. In no event shall Borland be liable for any loss of profit or any other 
commercial damage, including but not limited to special, incidental consequential or other damages. 


Governing Law 
This statement shallbe construed, interpreted, and governed by the laws of the state of California. Use, 
duplication or disclosure by the U.S. Covernment of the computer software and documentation in this 
package shall be subject to the restricted rights under DFARS 52.227-7013 applicable to commercial 
computer software. 


専門 プロ グラ マ の た め の Turbo C 2.0 ラン タイ ム ・ ラ イブ プラ リ ・ ソ ー ス コー ド 


Turbo C ラン タイ ム ・ ラ イプ ラリ ・ ソ ー ス コー ド に よっ て 、 皆 さん は 、 最 初 か ら 専 門 家 と し て 活躍 で きま す 。 こ の ソー スコ ー ド に よ 
り 、 皆 さん は Turbo C に つい て の 理解 を 深め る こと が で き 、 ま た 、 コ ン バ イ ラ ・ ル ー チ ン お よび ファ ンク ショ ン 内 部 の 仕組 み に つ いて 
詳し く 知 る こと が で きま すか ら 、 皆 さん の プロ グラ ム 環 境 の より 良い 管理 が 可能 と な り ま す 。 


TurboC ラン タイ ム ・ ラ イブ プラ リ に よっ て 、300 フ ァ ン クシ ョ ン 以 上 の ライ ブラ リ を カス タマ イズ する こと が で き 、 ま た 、 ル ー チ ン を 
追加 ・ 変 更 で きま す 。 し た が っ て 、 皆 さん の プロ グラ ム の 具体 的 ニー ズ が 、Turbo C ラン タイ ム ・ ラ イブ ラリ と 異な る 場合 に も 対処 す 
る こと が で きま す 。 ま た 、 厳 密 に コー ド 化 お よび 最適 化 さ れ た Turbo C ライ プラ リ の ルー チン を 利用 する こと が で き 、 し か も 、 そ れ が 
前 提 と し て いる 事柄 に 制限 され る こと は あり ませ ん 。 


コン バイ ラ 会 社 に は 、 ラ イプ ラリ ・ ソ ー ス コー ド を 提供 し な いと ころ も あり 、 そ の 代金 と し て 数 干 ドル も 請求 する 会 社 も あり ます 。 
その 結果 、 多 く の 専門 家 は 、 ラ イプ ラリ ・ ル ー チ ン の 動き に つい て 十分 理解 する た め に 、 や むせ なく 数 千 時 間 も 費 や し て 自分 自身 の ライ 
プラ リ を 書か ね ば な り ま せん 。 ポ ボー ラン ド で は その 手間 を 省 い て 、 マ イク ロ ・ コ ンピュータ の 歴史 に お いて 最も 人 気 の あ る コン バイ ラ 
の ソー スコ ー ド を 、 わ ず か 29.800 円 で 皆さん に ご 利用 いた だ こう と いう わけ で す 。 


今 すぐ TurboC ラン タイ ム ・ ラ イプ ラリ ・ ソ ー ス コー ド を ご 注文 くだ さい 。 注 文書 に ご 記入 後 「TurboC ラン タイ ム ・ ラ イプ ラリ ・ 
ソー スコ ー ド 注文 」 と 表書き の 上 、 下 記 ま で お 送り くだ さい 。 
また 、 ご 入金 も 下記 の 口座 まで お 願い いた し ます 。 
代理 店 
株 式 会 社 マイ クロ ソフ トウ ェ ア アソ シェ エイ ツ ( 略 称 MSA) 
〒107 東京 都 港 区 南青山 7 一 8 一 1 小田 急 南 青山 ビル 9F 
TEL 03-486-1411 プ FAX 03-486-8905 


お 振込 先 : 東海 銀行 九段 支店 当座 710357 


[注意 】 東 面 に 必要 事項 を ご 記入 後 、 切 り 取 ら ず に この まま ご 返送 くだ さい 。 控 え が 必 要 な 方 は コビー を お 取り 下さ い 。 
Turbo C 2.0 ラン タイ ム ・ ラ イプ ラリ ・ ソ ー ス コー ド 注 文書 


Turbo C シリ アル ナン バー メデ ィ ア ・ サ イズ 
個人 で 購入 され た 方 の み ご 記入 くだ さい 。 会 社 で 購入 きれ た 方 の み ご 記入 くだ さい 。 
お 名 前 お 会 社名 
ご 住 所 〒 ご 住所 〒 
TEL ご 所 属 

ご 担当 (お 名 前 ) 

TEL 


お 支払 方 法 ( 該 当 す る も の に V を つけ て くだ さい ) 
銀行 振込 (振込 日 年 月 日 : 口 文書 口 電信 ) 
現金 書留 

口 その 他 ( ) 


※ 本 契約 書 注 文書 の 受領 、 お よび 代金 お 支払 の 確認 後 1 ヶ月 以内 に 商品 発送 と な り ま す 。 
Turbo C 2.0 ラン タイ ム ・ ラ イブ ラリ ・ ソ ー ス コー ド 契 約 書 
Turbo C ラ ンタ イム ・ ラ イプ ラリ ・ ソ ー ス コー ド 実 施 契約 に つい て ポー ラン ド は また と な い 機 会 を 提供 し ます 


ポー ラン ド で は 、 今 一 度 、 総 好 の 機会 を 皆さん に 提供 いた し ます 。 和 経験 の 深い C プロ グラ マ と し て 、 皆 さん は TurboC ラン タイ ム ・ 
ライ プラ リ ・ ソ ー ス コー ド の 取扱 い が い か に 重要 で ある か を ご 存 知 で す 。 当社 で は 、TurboC ラ ンタ イム ・ ラ イプ ラリ ・ ソ ー ス コー ド 
を 、 た っ た 29.800 円 で 、 日 本 の Turbo C ユ ー ザ ー の 皆さん に 提供 いた し ます 。 

これ は 、 皆 さん が コー ド を より よく 理解 し 、Turbo C プロ グラ ム の 性 能 を 最大 限 に 活か すま た と な い 機 会 で す 。 

今 す ぐ TurbopC ラ ンタ イム ・ ラ イブ ラリ ・ ソ ー ス コー ド を ご 注文 下さ い 。 極 め て 貴重 で 信頼 性 の 高い TurboC ラ ンタ イム ・ ラ イブ 
ラリ ・ ソ ー ス コー ド を 利用 する た め に 、 ど う ぞ この ペー ジ の 注文 書 に ご 記入 の 上 、 代 理 店 宛 に お 申し 込み 下さ い 。 


Turbo C 2.0 ラン タイ ム ・ ラ イブ ラリ ・ ソ ー ス コー ド ノ ボ ー ラ ンド の 実用 的 な 実施 契約 


ポー ラン ド ・ イ ンタ ー ナ ショ ナル (以下 「 ポ ボーラ ンド 」) は 、Turbo C の 中 に 含ま れる Turbo C ライ ブラ リ の 部 分 の ソー スコ ー ド ( 以 
下 「 ツ ー ス ・ プ ログ ラム 」)、 お よび 、 別 料金 に て 、 後 日 ポー ラン ド が 提供 する 更新 デー タ (た だ し 8087 エ ミュ レー タ と グラ フィ ックス 
ライ プラ リ の ソー スコ ー ド は 含ま れ ま せん ) の 実施 契約 の 募集 を 行っ て お り ま す 。 

この ソー ス ・ プ ログ ラム は 、 米 国 著作 権 法 お よび 国際 条約 に よっ て 保護 され て お り ま す の で 、 下 記 の 唯一 の 例外 事項 を 除い て 書籍 と 
同様 の 取扱 い が 必要 で す 。 皆 さん は 皆さん の プロ グラ ム の バックアップ の た め 、 そ れ か ら 皆 さん の 支出 に つい て 損 さ れ な いた め に の み 
ソー ス ・ プ ログ ラム の 保存 用 コビー を 作成 する こと が で きま す 。 

「 書 籍 と 同様 に 」 と は 、 た と えば 、 ソ ー ス ・ プ ログ ラム の 使用 者 数 に 制限 を 設け ず 、 捜 数 の コン ビ ピュータ ・ ワ ー ク ステ ーション で 同 
時 に 使用 され る 可能 性 が な い 限 り 、 ソ ー ス ・ プ ログ ラム は その 間 を 自由 に 移動 する こと が で きる と いう 意味 で す 。 書 籍 が 同時 に ヶ所 
で 二 人 の 人 間 に よ っ て 読ま れる の が 不可 能 で ある の と 同様 に 、 ソ ー ス ・ プ ログ ラム も 、 同 時 に 二 ヶ 所 の 異な っ た 場所 で 二 人 の 異な っ た 
人 間 に よ っ て 使用 する こと は で きま せん 。( も ちろ ん ポー ラン ド の 著作 権 を 侵害 すれ ば 別 で す 。) この 制限 付 保証 は 、 し か し 、 皆 さん 自 
身 に よる ソー ス ・ プ ログ ラム の 変更 に 起因 し た 欠 陥 に は 適用 され ませ ん 。 

ソー ス ・ プ ログ ラム は 、Turbo C の 実施 許諾 コビー を サポ ー ト する た め に 使用 で きま す 。 こ れ は どう いう こと か と 申し ます と 、 ソ ー 
ス ・ プ ログ ラム を 皆さん 自身 が 開発 する TurboC ベ ペー ス の プロ グラ ム の コビー に 含め る こと が で きる と いう こと で す が 、 そ れ は 実行 可 
能 な 形式 に お いて の み 、 そ れ ら を 配付 で きる と いう 意味 で す 。 実 際 の Turbo C ラ ンタ イム ・ ラ イプ ラリ ・ ソ ー ス コー ド の いか な る 部 分 
も 配付 で きま せん 。 も ちろ ん 、 皆 さん 自身 の ソー スコ ー ド の 配付 は 制 良 され ませ ん 。 

皆さん は ソー ス ・ プ ログ ラム を 変更 する こと は で きま す が 、 変 更 され た ソー スコ ー ド の 所 有 権 は 、 そ の 変更 の 程度 と は 無関係 に 、 ポ 
ー ラ ンド に 届 し ます 。 皆さん は ポー ラン ド の 著作 権 、 そ の 他 の 財産 権 に 関す る 表示 を 除去 し た り 変 更 し た りす る こと は で きま せん 。 ま 
た 、 変 更 の 程度 と は 無関係 に 、 ソ ー ス ・ プ ログ ラム の いか な る 部 分 も 配付 で きず 、 他 の コン ピュ ー タ の オペ レー ティ ング ・ シ ステ ム ま 
た は 環境 に 移す こと は で きま せん 。 皆さん は 、 皆 さん 自身 に よる ソー ス ・ プ ログ ラム の 変更 、 お よび その プロ グラ ム を 含む 製品 に 起因 
する すべ て の 請求 責任 お よび 損害 に つい て 責任 を 負わ ね ば な り ま せん 。 

この 実施 権 に よっ て 明示 的 に 付与 され て いな い 権 利 は 、 す べ て ポー ラン ド が 留保 し ます 。 


制限 付 保証 


実際 の ディ スケ ッ ト お よび ドキ ュ メ ン テ ー シ ョ ン に つい て は 、 ポ ボー ラン ド は その 材料 お よび その 仕上 に 欠陥 が な いこ と を 保証 し ます 
これ は 、 購 入 後 60 日 間 の 限定 保証 で す 。 ポ ボー ラン ド が 、 こ の 60 日 以内 に 、 材 料 ま た は その 仕上 の 欠陥 に つい て 文書 に よる 通知 を 受け た 
場合 に は 、 そ の ディ スケ ッ ト ま た は ドキ ュ メ ン テ ー シ ョ ン を 交換 いた し ます 。 皆 さん が 製品 を 返却 し た いと 思う 場合 に は 、 返 却 許可 番 
号 の 決定 手続 き の た の め に 、 代 理 店 まで 連絡 し て くだ さい 。 

また 、 ポ ー ラ ンド お よび 代理 店 は 、 ソ ー ス ・ プ ログ ラム の 使用 に 関し 、 技 術 的 な 援助 は 提供 し ませ ん 

この 制限 付 保証 の 違反 に 対す る 救済 手段 は 、 デ ィ ス ケッ ト お よび ドキ ュ メ ン テ ー シ ョ ン の 代 天 に 限定 され 、 そ の 他 の 損害 賠償 は 含ま 
れ ま せん 。 ポ ー ラ ンド は 、 た と える 当方 の 代理 店 が その よう な 損害 の 可能 性 に つい て あら か し め 通 知 き され て いて も 、 利 益 の 損失 、 ま た は 
その 他 の 商業 上 の 損害 を 含む 間接 損害 、 特 別 損害 、 そ の 他 の 類似 の 損害 また は 請求 に つい て 商 任 を 負い ませ ん 。 ま た 、 い か な る 場合 に 
も 、 皆 さん また は その 他 の 者 の 損害 に 対す る ポー ラン ド の 責任 は 、 請 求 の 形式 を 問わ ず 、 ソ ー ス ・ プ ログ ラメ ム 実施 権 に つい て 支払 われ 
る 代価 を 超え る も の で は あり ませ ん 。 

ポー ラン ド は 、 そ の 他 の いか な る 明示 また は 映 示 の 保証 も 行い ませ ん 。 具体 的 に は 、 ポ ボー ラン ド は 、 ソ ー ス ・ プ ログ ラム が 特定 の 用 
途 に 対し て 適合 する こと を 保証 する も の で は あり ませ ん 。 商 業 価値 に 対す る 保証 は 、60 日 の 保証 期間 に 限っ て 実際 の ディ スケ ッ ト お よ 
び ド キュ メン テー ショ ン (ソー ス ・ プ ログ ラム は 含ま れ ま せん ) に つい て の み 行 われ る 制限 付 保証 で 、 そ の 他 に つい て は 保証 し な いこ 
と を 明示 し ます 。 

この 制限 付 保証 に より 、 皆 さん は 具体 的 な 法 的 権利 を 付与 され ます 。 権 利 の 内 容 は 国 は 州 に より 異な り 、 国 や 州 に よっ て は 付随 的 ま 
た は 間接 的 損害 の 除去 や 咽 示 保証 の 期間 制限 を 認め な を いと ころ も あり 、 従 っ て 、 前 記 の 規定 が 皆さん に 適用 され な い 場 合 も あり ます 。 


準拠 お よび 一 般 規定 
本 実施 契約 は 、 カ リフ ォ ル ニア 州法 に 基づき 、 解 釈 ・ 規 制 さ れる も の と し 、 そ の いずれ か の 条項 が 無効 また は 実施 不可 能 の 場合 に お 
いて も 、 本 契約 の 他 の 条項 の 効力 は 影響 を 受け ず 、 そ の 条件 通り に 実行 され る も の と し ます 。 本 契約 に 基づく 救済 手段 が 、 そ の 本 来 の 


目的 を 達成 で き な い 場 合 に お いて も 、 本 契約 に 定め る 責任 の 限定 お よび 損害 賠償 の 除外 に 関す る すべ て の 規定 は 、 全 面 的 に その 効力 を 
持続 する も の と し ます 。 本 契約 は 、 皆 さん お よび ポー ラン ド の 権 恨 あ る 代表 者 が 署名 し た 文書 に よる 以外 、 変 更 で き な い も の と し ます 。 


私 は 、 前 記 に つい て 読了 し 、 了 解い た し ます 。 私 が 抱い た すべ て の 攻 問 に 対し て は 納得 の いく 回 答 が な な され て いま す 。 


午 名 杜 氏名 : 
会 社名 : (あて は まる 場合 の み ) 
日 付 : Turbo C シリ アル 番号 


ポー ラン ド か ら の 製品 の 出荷 を も っ て 、 本 契約 の 承諾 に 代え させ て いた だ きま す 。 
Turbo C ラ ンタ イム ・ ラ イプ ラリ ・ ソ ー ス コー ド の ご 注文 に 際 し て は 、 こ の 裏側 の ペー ジ を お 読み くだ さい 。 


リフ ァ レ ンス ガイ ド 
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は じ め に 


この マニ ュ ア ル は , Turbo C パ ッ ケ ー ジ の 2 二 目 の マニ ュ ア ル 「Turbo C リ ファ レン ス 
ガイ ド 」 で, TurboC の ライ プラ リル ー チ ン , コモ ン 変 数 。 コモ ン 型 の すべ て の 定義 を 含 
ん で お り ,、 さら に プロ グラ ム 例 を 示し て , 各 ル ー チ ン , 各 変 数 、 各 型 を どの よう に 使え ば 
よい か に つい て 説明 し て あり ます 。 

C で の プロ グラ ミン グ が 初め て の 場合 は 、 Turbo C の 1 氏 目 の マニ ュ ア ル 「Turbo C ュ 
ー ザ ー ズ ガイ ド 」 を まず 先 に 読ん で くだ さい 。 ユ ー ザ ー ズ ガイ ド に は , TurboC を 使用 す 
る シス テム で どの よう に イン スト ー ル する か , また TurboC で プロ グラ ミン グ を 始め る 際 
に 助け に な る 入門 者 向け の 章 が 用 意 き れ て いま す 。 ユ ー ザ ー ズ ガイ ド に は , C 言 語 が 
TurboC に お いて どの よう に 実現 され て いる か に つい て の 詳細 も 述べ られ て いま すし , 少 
し 高度 な プロ グラ ミン グ テ ク ニッ ク に つい て も 触れ られ て いま す 。Turbo Pascal お よび 
Turbo Prolog を すでに 使っ て いる ユー ザ が , Turbo C を 理解 し や すく する た め の 章 も 設 
けら れ て いま す 。 

と に か く 〈, まず ユー ザー ズ ガ イド の 最初 の 章 「 は じ め に 」 に 述べ られ て いる TurboC 処 
理系 に 関す る 情報 , ユー ザー ズ ガ イド の 内 容 の 要約 , 簡単 な 参考 文献 り スト を 読ん で くだ 
さい 。 


分 民 II: リ ファ レン スガ イド 


この TurboC リ ファ レン スガ イド は , C に つい て 一 通り わか っ て いる 人 の た め に 書か れ 
て お り , 言語 お よび 実行 時 の 環境 に 関す る 処理 系 特有 の 詳細 に つい て 述べ られ て いま す 。 
その あと 、 Turbo C で 使用 で きる 関数 の 定義 が ABC 順 で 与え られ て いま す 。 こ の リフ ァ 
レン スガ イド の 各 音 に つい て の 簡単 な 要約 を 示し ます 。 


第 1 章 「TurboC ラ イプ ラリ ルー チン を 使う に は 」 で は 、 イ ンク ルー ド フ ァイル (.h) の リ 
スト と 要約 , Turbo C ラ イプ ラリ ルー チン の カテ ゴリ 別 の 一 覧 を 示し 、 maimn 関数 に つい 
て 説明 し て いま す 。 そ の あと , 定義 済み の グロ ー バ ル 変 数 を ABC 順 で 解説 し て いき ます 。 


第 2 章 「Turbo C ラ イプ ラリ 」 で は , Turbo C の すべ て の ライ ブラ リ 関 数 を ABC 順 で 示 
し , 説明 を 加え ます 。 各 関数 に 対し て , その 形式 、 イン クル ー ド ファ イル , 関連 関数 機 
能 の 説明 戻り 値 , 可 搬性 が 示さ れ て いま す 。 な お , テキ スト ビデ オラ イプ ラリ 、 グラ フ 
ィ ッ クス ライ ブラ リ , BIOS サポ ー ト ライ ブラリ 、 日 本 語 処理 ライ プラ リ に つい て は , 
Turbo C 標準 ライ プラ リ と は 別に それぞれ 節 を わけ て 解説 し て あり ます 。 


付録 A「 コ ン パ イラ エラ ー メ ッ セ ー ジ 」 で は , すべ て の エラ ー メ ッ セ ー ジ に つい て 説明 
し , 考え られ る 原因 も 示し て いま す 。 


付録 B「 言 語 構文 の 要約 」 で は , 修正 BNF (バッ カス ナウ ア 記 法 ) で TurboC の すべ て 
の 構文 が 記述 され て いま す 。 
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マニ ュ ア ル 表 記 に 関す る 規約 (書体 ) 


マニ ュ ア ル の 表記 に 際 し て 使用 され る 特殊 な を も の と し て 次 の よう な も の が あり ます 。 
前 | 書式 や MS-DOS コマ ンド ライ ン に お ける 大 カッ コ [ ] は , シス テム に よっ て 
異な る オプ ショ ン の 入力 や デー タ を 囲む も の で す 。 そ の と お り に カッ コ を タタ 
イプ し て は いけ ませ ん 。 


く > 関数 の 説明 に お ける 不 等 号 は 、 イ ンク ルー ド フ ァイル を 囲む の に 使わ れ ま す 。 


Boldface TurboC の 関数 名 (primtf な ど ) は この よう な ポー ルド 体 で 表記 し て いま 


す 。 

Gothic Turbo C の 予約 語 (char, switch, near, cdecl な ど ) は ゴシック 体 で 表わし 
ます 。 

7g/c 関数 に 渡す 引数 名 (sg, pg 人 が な ど ) は イタ リッ ク 体 で 表記 し ます 。 


go/g-7fg/zc Turbo C で 定義 きれ て いる グロ ー バ ル 変 数 ( zoge, eryzo な ど ) は この 
書体 で 表記 し ます 。 


KEYCAPS キー ポー ド 上 の キー (7O, GP-X, DEL な ど ) は この 書体 で 表記 し ます 。 
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は じ め に 


製品 に 関す る お 問い 合わ せ 


ソフ トウ ェ ア お よび マニ ュ ア ル に 関し て ご 質問 ・ ご 意見 な ど が あり まし た ら , 下記 の 
MSA カス タマ ー サ ポー ト セ ンタ ー ま で , お 電話 書面 また は ファ クシ ミリ に て お 問い 合わ 
せく だ さい 。 な お , お 電話 で の 受付 時 間 は 平日 の 9 : 00amー12 : 00am お よび 1 : 00pm 
て 5 : 00pm と させ て いた だ きま す (土曜 日 曜 、 祝 日 は 休業 と させ て いた だ きま す の で 御 
了承 くだ さい )。 


〒107 東京 都 港 区 南青山 7-8-1 小田 急 南青山 ビル 
(株 ) マイ クロ ソフ トウ ェ ア ア ソ シ ェ イツ 
カス タマ ー サ ポー ト セ ンタ ー 
(TEL) 03-486-1403 
(FAX) 03-486-8905 


お 問い 合わ せ の 際 に は , 下記 の 事項 を お 伝え くだ さい 。 

罰 製 品名 と バー ジョ ン 番 号 (Turbo C 2.0 な ど ) 

田 製 品 の シリ アル 番号 (マス ター ディ スク に 記載 され て いる も の ) 
圏 コ ンピュータ 名 と モデ ル 番 号 (PC-9801VX な ど ) 


圏 オペレーティング シス テム と バー ジョ ン 番 号 (MS-DOS 3.1 な ど ) 


を な お, 書面 に て お 問い 合わ せ の 際 に は 、CONFIG.SYS お よび AUTOEXEC.BAT の 内 
容 , 簡潔 な プロ グラ ムリ スト を 添付 され る よう お 願い 致し ます 。 
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第 1 章 
Turbo C ラ イブ ラリ ルー チン を 使う 


TurboC に は , 450 個 以上 の ライ プラ リル ー チ ン (関数 と マク ロ ) が 含ま れ て いま す 。 C 
の プロ グラ ム の 中 か ら こ れ を 呼び 出す こと が で きる わけ で , じつに さま きま な 種類 の 仕事 
を 行なう こと が で きま す 。 低 レベ ル か ら 高 レ ベル まで の 入出 力 , 文字 列 あ る い は ファ イル 
に 対す る 操作 、 メ モリ 割り 当て 、 プ ロ セ ス 制 御 、 デ ー タ 変換 、 数 学 的 計算 、 そ の 他 た くさ 
ん の こと が で きる の で す 。 

Turbo C の ルー チン は ,、 ラ イプ ラリ ファ イル (Cx.LIB, MATHx.LIB、 お よび 
GRAPHICS.LIB) に 含ま れ て いま す 。Turbo C で は 6 種類 の メモ リモ デル が 用 意 さ れ て い 
る の で , タイ ニ ィ を 除く 各 メ モリ モデ ル は , それ ぞ れ 独自 の ( 各 メ モリ モデ ル 用 に 書か れ 
た ルー チン も 含め て ) ライ プラ リフ ァイル と 数 学 ラ イプ ラリ ファ イル を 持っ て いま す ( タ 
イニ ィ モ デル は スモ ー ル の ライ プラ リフ ァイル を 使用 し ます )。 

TurboC は ANSI の C 標準 化 案 を サポ ー ト し て お り ,C の プロ グラ ム の 中 で 使用 され る 
関数 に 対し て , 関数 プロ ト タイ プ を 宣言 する こと が で きま す 。TurboC の 関数 すべ て に つ 
いて , プロ ト タイプ が 1 個 ま た は 複数 の ヘッ ダフ ァイル の 中 で 宣言 され て いま す (ヘッ ダフ 
ァイル は ,.h ファ イル や イン クル ー ド ファ イル と 呼ば れる も の で , INSTALL プロ グラ ム 
に よっ て マス ター ディ スク か ら サ プ デ ィ レ クト リ INCLUDE に コピ ー さ れる も の で す )。 


この 章 で は …… 


この Turbo C リ ファ レン スガ イド の 最初 の 部 分 で は , Turbo C の ライ プラ リル ー チ ン 
と イン クル ー ド ファ イル を 概観 し 、 main 関数 の 働き も, グロ ー バ ル 変 数 に つい て 説明 し ま 
ず 。 


田 ど ん な 場合 に Turbo C ラ ンタ イム ライ ブラ リ の ソー スコ ー ド か 必要 に な る か に つい 


て 説明 し ます 。 
較 イ ンク ルー ド フ ァイル の 一 覧 表 を 示し , 各々 に つい て 説明 を 加え ます 。 


製品 に 関す る お 問い 合わ せ Z 


行 な う 仕 事 の 種類 に よっ て ライ プラ リル ー チ ン を 分 類 し ます 。 

田 main 関数 に 渡さ れる 引数 と , その 戻り 値 に つい て 説明 し ます 。 

圏 ラ イプ ラリ ルー チン の 多く て で 使用 され る コモ ング ロー バル 変数 を , ABC 順 で 解説 し ま 
す 。 
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ライ ブラ リル ー チ ン ・ リ ファ レン ス 


この リフ ァ レ ンス ガイ ド の 第 2 章 は ,、 ライ プラ リル ー チ ン の ABC 順 の リフ ァ レ ンス で あ 
り , Turbo C ル ー チ ン の すべ て に つい て 解説 し て いま す 。 

いく つか の ルー チン は , 似通っ た 仕事 ある い は 深く 関連 し た 仕事 を 行なう た め に , “ファ 
ミリ ィ イィ" と し て まとめ られ て いま す ( た と えば , プロ グラ ム を 作成 , ロー ド , お よび 実行 す 
る exec.… や spawn.…) 。 

そう でない 関数 に つい て は 、 必 ら ず 1 つの 項目 を と っ て あり ます 。 た と えば , free と いう 
名 前 の 関数 に つい て 知り た けれ ば , free の 項 を 見 ます 。 そ こ に は 以下 の よう な こと が 書か 
れ て いま す 。 


罰 free が 行なう こと の 要約 

田 free を 呼び 出す た め の 形 式 (構文 ) 

田 free に 対す る プロ ト タ イ プ を 含ん で いる ヘッ ダフ ァイル の 名 前 

田 free が どの よう に イン プリ メン ト さ れ て いる か , お よび 他 の メモ リ 割 り 当 て 関数 と ど 
の よう に 関連 し て いる か に 関す る 解説 

罰 同 様 な 関数 を 含ん で いる た の シス テム の リス ト 

田 関 連 の ある 他 の Turbo C 関 数 

田 も の に よっ て は , その 関数 を どの よう に 使え ば よい か を 示す サン プル プロ グラ ム , あ 
る い は サン プル が どこ に の っ て いる か 


この リフ ァ レ ンス ガイ ド の 最後 に ある 付録 で は ,、 すべ て の コン パイ ラ エ ラー メッ セー ジ 
の 説明 、 お よび 言語 構文 の 要約 が 示さ れ て いま す 。 
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Turbo C ラン タイ ムラ イブ ラリ ・ ソ ー ス コー ド 


Turbo C ラ ンタ イム ライ プラ リ に は 、 広範 な 領域 を カバ ー す る 300 以 上 の 関数 が 含ま れ 
て いま す 。PC の 低 レ ベル で の 制御 」DOS と の イン ター フェ ー ス , 入力 / 出 力 、 プ ロ セ ス 管 
理 , 文字 列 お よび メモ リ 操 作 , 数 学 計算 、 ソ ー ト / 検 索 、 な ど で す 。 ラ ンタ イム ライ ブラ リ 
の ソー スコ ー ド が 欲し く な る 理由 は いく つか 考え られ ます 。 


田 TurboC の ある 関数 が , 自分 が 書き た い 関数 に 似 て は いる けれ ども ,、 ま っ た く ピ ッ タ 
リ と いう わけ で は な いこ と が あり ます 。 ラ ンタ イム ライ ブラリ ・ ソ ー ス コー ド が あれ 
ば , 欲し い 関数 を 丸々 書か な く て も ,、 ライ ブラ リ 関 数 を 必要 に 応じ し て 加工 する こと が 
で きま す 。 

圏 コー ド を デベ バッグ し て いる と き に , ライ ブラ リ 関 数 の 内 部 に つい て より 詳し く 知 り た 
く な る こと が あり ます 。 こ ん な と き に は , ラン タイ ムラ イブ ラリ ・ ソ ー ス コー ド が 大 
き な 助 け と な る で し ょ う 。 

較 C の シン ボル に 下線 を つけ る 慣例 が 気 に く わ ず , 下線 が つい て いな い バ パー ジョ ン の ラ 
イプ ラリ が 欲し いと いう 人 が いる か も し れ ま せん 。 こ ん を な 場合 も 、 ラ ンタ イム ライ ブ 
ラリ ・ ソ ー ス コー ド が あれ ば , 下線 を 取り 除い た ライ プラ リ を 作る こと が で きま す 。 

圏 また 、 プロ フェ ッ シ ョ ナル が 書い た 級 密 な ライ プラ リソー スコ ー ド か ら , 学び 取れ る 
こと が た くさ ん ある で し ょ う 。 


こう し た 理由 か ら , ある い は また 別 の 理由 か ら , TurboC ラ ンタ イム ライ ブラリ ・ ソ ー 
スコ ー ド が か が 必要 に な る で し ょ う 。 ポ ボー ラン ド は , “オー プン アー キテ クチ ャ "と いう 考え を 
強く 持っ て いる の で , ライ セン ス 契 約 に よっ て , ユー ザ が Turbo C ラ ンタ イム ライ プラ 
リ ・ ソ ー ス コー ド を 利用 で きる シス テム を と っ て いま す 。 ユ ー ザ ー ズ ガイ ド の 最初 に つい 
て いる 注文 書 に 必要 な 事項 を 記入 し て 送付 し 、 所 定 の 方 法 で 費用 を お 支払 いた だ けれ ば , 
TurbopoC ラ ンタ イム ライ プラ リ ・ ソ ー ス コー ド が お 手もと に 届け られ ます 。 詳 し く は MSA 
サポ ー ト セン ター まで 問い 合せ て くだ さい 。 
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Turbo C と イン クル ー ド ファ イル 


ヘッ ダフ ァイル で は , ライ ブラ リ 関 数 の 関数 プロトタイプ が 宣言 され て いま す 。 ま た 。 
ライ プラ リ 関 数 が 使用 する デー タ 型 や シン ポリ ッ ク 定 数 の 定義 、 TurboC や ライ ブラ リ 関 
数 が 定義 し て いる グロ ー バ ル 変 数 も 含ま れ て いま す 。TurboC の ヘッ ダフ ァイル 名 と その 
内 容 は , ANSI の C 標 準 案 に 従っ て いま す 。 以 下 の リ スト で は , ANSI C で 定義 され て い 
る ヘッ ダフ ァイル に は アス タリ スク (*) が つけ られ て いま す 。 


alloc.h メモ リ 管 理 関 数 (割り 当て , 解放 な ど ) を 定 言 し て いま す 。 

assert.h *※ assert デバ ッ ギ ング マク ロ を 宣言 し て いま す 。 

bios.h IBM PC の ROM ルー チン の 呼び 出し に 使用 きれ る さま さま な 関数 が 宣 
言 さ きれ て いま す (IBM PC の み )。 

bios98.h NEC PC-9801 の ROM ルー チン の 呼び 出し に 使用 きれ る さま ざま みな 関数 
や デー タ 型 が 宣言 され て いま す (PC-9801 の み )。 

conio.h 直接 コン ソー ル 1/O ルー チン を 呼び 出す の に 使わ れる 関数 を 宣言 し て い 
ます 。 

ctype.h * 文字 の 分 類 , お よび 変換 マク ロ (isalpha や toascii) に よっ て 使わ れる 情 
報 を 含ん で いま す 。 

dir.h ディ レク トリ や バス 名 を 取り 扱う 場合 に 必要 と な る 構造 体 、 マ クロ , 関数 
を 含ん で いま す 。 

dos.h MS-DOS や 8086 に 特有 の 呼び 出し に 必要 な 定数 を 定義 し , 宣言 を 行なっ 
て いま す 。 

errnoh ネ エラ ー コ ー ド に 対応 する ニー モニ ッ ク 定 数 を 定義 し て いま す 。 

fnctlh ライ プラ リル ー チ ン opem と 関連 し て 使用 きれ る シン ポリ ッ ク 定 数 を 定義 
じ て い ます 。 


floath * 浮動 小数 点 ル ー チ ン 用 の パラ メー タ を 含ん で いま す 。 
graphics.h グラ フィ ックス 関数 の プロ ト タ イ プ を 合 言 し て いま す 。 


io.h 低 レ ベル の 入力 / 出 力 ル ー チ ン に 対す る 構造 体 お よび 宣言 を 含ん で いま す 。 

jctype.h 日 本 語 処理 関数 が 使用 する 文字 分 類 テ ー ブ ル な どの 情報 が 含ま れ て いま す 
(PC-9801 の み )。 

jstring.h 日 本 語 対 応 の 文字 列 操作 ルー チン の プロ ト タ イ プ が 宣言 され て いま す 
(PC-9801 の み )。 


limitsh * 環境 パラ メー タ 、 コ ン バ イ ル 時 の 制限 値 に 関す る 情報 、 各 種 整 数 の 値 の 許 
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mathh * 


mem.h 


music.h 


process.h 
setmp.h * 


share.h 
signal.h ※ 


stdarg.h * 


stddefh * 
stdio.h ※ 


stdlib.h * 


string.h * 
sys\stat.h 


sys\timeb.h 
SysS\types.h 
time.h * 


Yalues.h 
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きれ る 範囲 を ど を 含ん で いま す 。 

数 学 関数 の プロ ト タ イ プ を 宮 言 し 、HUGE_ VAL マク ロ を 定義 し , math- 
err や _matherr ルー チン に よっ て 使用 され る exeption 構造 体 を 宣言 し 
GWS ま ずら 

メモ リ 操 作 関 数 を 宜 言 し て いま す ( そ の 多く は , string.h の 中 で も 定義 きれ 
て いま す )。 

PC-9801 の サウ ンド ポー ド を 制御 する 関数 や 関連 する デー タ 型 を 宣言 し て 
いま す (PC-9801 の みろ)。 

spawn… お よび exec.… 関 数 用 の 構造 体 と 家 言 を 含ん で いま す 。 

longjmp お よび setimp 関数 に よっ て 使わ れる が の 型 を 定義 し 、lon- 
gmp と setjmp の プロ ト タイプ を 宣言 し て いま す 。 

ファ イル の 共有 を 行なう 関数 で 使用 され る パラ メー タ を 定義 し て いま す 。 
signal と raise 関数 が 使用 する 定数 や 宣言 を 定義 し て いま す 。 

引数 の 個数 が 可変 と 宣言 され た 関数 (vprintf、vscanf な ど ) で , 引数 リス 
ト を 読む た め に 使わ れる マク ロ を 定義 し て いま す 。 

一 般 的 に 使わ れる デー タ 型 や マク ロ を 定義 し て いま す 。 

カー ニハ ン と リッ チ ィ に よっ て 定義 され ,、 UNIX シス テム 上 て 拡張 され 
た , 標準 入出 力 バ ッ ケ ー ジ に 必要 な 型 と マク ロ を 定義 し て いま す 。 ま た , 
標準 1/O スト リー ム sd 訪 、 sdo4/。 sdey を 定義 し 、 スト リー ムレ ベル 1I/ 
0 ルー チン を 人 宜 言 し て いま す (以降 カー ニハ ン と リッ チ ィ は K&R と 遇 し 
ます )。 

一 般 的 に 使用 きれ る ルー チン (変換 ルー チン , サー チ / ソ ー ト ルー チン , そ 
の 他 ) を 宣言 し て いま す 。 

文字 列 操作 お よび メモ リ 操 作 ル ー チ ン を 宣言 し て いま す 。 

ファ イル を オー プン し た り , 作成 し た りす る の に 使わ れる シン ポリ ッ ク 定 
数 を 定義 し て いま す 。 

ftime 関数 と 、ftime が 返す 構造 体 timeb を 宮 言 し て いま す 。 

時 刻 関数 と と も に 使用 され る ze 7 型 を 宣言 し て いま す 。 

時 刻 変換 ルー チン asctime, localtime, gmtime で 埋め られ る 構造 体 、 お 
よび ctime、 difftime、 gmtime, localtime に よっ て 使わ れる 型 を 定義 し 
て いま す 。 こ れ ら の ルー チン の プロ ト タイ プ も 宣言 され て いま す 。 
重要 な 定数 を (マシ ン 依 存 性 も 含め て ) 定義 し て いま す 。UNIX シス テム 
V と の 互換 性 の た め に 提供 され て いま す 。 
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ライ ブラ リル ー チ ン の 分 類 


Turbo C ラ イプ ラリ ルー チン は , さま ざま を 種類 の タス ク を 行ない ます 。 こ の 節 で は , 
ルー チン の 一 覧 表 と , その ルー チン が 宣言 され て いる イン クル ー ド ファ イル も 合わ せ て 示 


ASCII 文字 を 英字 , コン トロ ー ル 文字 , 区 切り 文字 , 英 大 文字 な ど に 分 類する も 


し て いま す 。 
文字 分 類 ル ー チ ン : 
の で す 。 
(ctype .h) 
(ctype・h) 
(ctype・h) 
scntr1 (ctype.h) 
変換 ルー チン : 


sdigit 
1sgraph 
1s1ower 
sprint 


(ctype・h 


) 


(ctype・h) 


(ctype・h 
(ctype.h 


) 
) 


spunct 
1sspace 
1supper 
1sxdigit 


(ctype・b) 
(ctype・h) 
(ctype・h) 
(ctype・h) 


文字 や 文字 列 を 変換 する も の で す 。 文 字 列 か ら 数 値 ( 浮 動 小 数 点数 、 整数 倍 長 整数) 
へ の 変換 や 、 その 逆 の 変換 , 英 大 文字 か ら , 英 小文字 へ の 変換 や その 逆 。 と いっ た も 


の で す 。 


atof 
atol 
ato1 
ecvt 
fcvt 
gcvt 


ディ レク トリ 操作 ルー チン : 


(std1ib.h) 
(std1ib.h) 
(std1ib.h) 
(mtd1ib.h) 
(std1ib.h) 
(std1ib.h) 


1toa 
1toa 
Strtod 
strto1 
trtou1 
toascii 


(std1ib. 
(std1ib. 
(std1ib. 
(std1ib. 
(std1ib. 


b) 
ょ ) 
) 
h) 
h) 


(ctype・h) 


ディ レク トリ や バス 名 を 操作 する も の で す 。 


chdir 
Elndfirst 
1ndnext 
fnmerge 
fnsplit 


診断 ルー チン : 


(dir.h) 
(dir.hb) 
(dir.h) 
(dir.h) 
(dir.h) 


8etcurdir 
getcwd 
getdisk 
mkdir 
mktemp 


組み 込み の エラ ー 処 理 ル ー チ ン で す 。 


asBert 


(assert.h) 
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matherr 


(dir 
(dir 
(dir 
(dir 
(dir 


(math.h) 


・b) 
・b) 
・b) 
・b) 
・b) 


to1ower 
_to1ower 
toupper 
toupper 
u1toa 


rmdir 
searchpai 
setdisk 


Perror 


(ctype・h) 
(ctype・h) 
(ctype・1) 
(ctype・h) 
(std1ib.h) 


(dir.h) 
th (dir.h) 
(dir.h) 


(errno-h) 


グラ フィ ックス ルー チン : 
画面 上 に テキ スト を 含む グラ フィ ックス を 作成 する ルー チン で す 。 


arc (graphtcs .h) graphresu1t (graphics.h) 
bar (graphics.h) 1magesize (graphlcs.h) 
bar3d (graphics.h) 1nitgraph (graphics.b) 
circ1e (graphcs.h) 1nsta11userdriver (graphcs .h) 
c1eardevice (graphics.h) nsta11userfont (graphics .h) 
c1earviewport (graphics.h) 1ine (graphtcs.h) 
c1osegraph (graphics.h) 1inere1 (graphtcs.h) 
detectgraph (graphics.h) 1ineto (graphtcs.h) 
dcawpo1y (graphics.h) movere1 (graphics.h) 
e11ipse (graphtcs.h) moveto (graphics.h) 
fil1e11ipse (graphtcs.h) outtext (graphics.h) 
Ei11poly (graphcs.h) outtextxy (graphics.h) 
E1oodfi11 (graphcs.h) pies1ice (graphcs.b) 
getarccoords (graphics.h) putimage (graphics.h) 
getaspectratio (graphics.h) putpixel (graphics.h) 
getbkcolor (graphics.h) rectangle (graphics.h) 
getcolor (graphics.h) regtsterbgidriver (graphics.h) 
getdefaultpalette (graphics .h) registerbgifont (graphics.h) 
getdrivername (graphics.h) restorecrtmode (graphtcs.h) 
getEi1lpattern (graphics.h) sector (graphics.h) 
getf111settings (graphics.h) setactivepage (graphics.h) 
getgraphmode (graphics.h) setal1palette (graphics.h) 
getimage (graphtcs.h) setaspectratio (graphics.h) 
getlinesettings (graphics.h) setbkcolor (graphtcs.b) 
getmaxco1or (graphics.h) setco1or (graphics.h) 
getmaxmode (graphics.h) setf111pattern (graphics.h) 
getmaxx (graphics.b) tE111sty1e (graphcs.b) 
getmaxy (graphics.h) setgraphbufsize (graphics.h) 
getmodename (graphtcs.h) setgraphmode (graphics.h) 
getmoderange (graphics.h) t1inestyle (graphics.h) 
getpalette (graphics.h) setnewdriver (graphics.h) 
getpalettesize (graphtcs.h) setpalette (graphics.h) 
getpixel (graphics.h) trgbpalette (graphics.b) 
gettextsettings (graphics.h) settext ]ustEy (graphics.h) 
getyiewsettings (graphics.h) settextsty1e (graphics .h) 
getx (graphics.h) setusercharslze (graphics.h) 
gety (graphics.h) setviewport (graphics.h) 
graphdefau1ts (graphics.h) setylsua1page (graphics .h) 
grapherrorm9g (graphics.h) setwritemode (graphics.h) 
_graphfreemem (graphics.h) texthe1ght (graphice.h) 
_graphgetmem (graphcs.h) textwidth (graphtcs.h) 
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入力 / 出 力 ルー チン : 
スト リー ムレ ベル お よび DOS レベ ル の 1/O 機能 を 提供 する ルー チン で す 。 


acces8 (io.h) fputc (stdio.h) putw (stdio.h) 
cgets (conio-h) fputchar (stdio.h) _read (io.h) 
_chmod (do.h) Eputs (stdio.h) read (io.h) 
chmod (io. ぅ ) Eread (stdio.h) remove (stdio.h) 
chslze (lo.h) freopen (stdio.h) rename (stdio.h) 
clearerror (stdio.h) fscanf (stdio.h) rewind (stdio.h) 
cl1ose (io.h) fseek (stdio.h) Scanf (stdio.h) 
_c1ose (io.h) Esetpos (stdio.h) setbuf (stdio.h) 
cprtntE (conio.h) fetat (syswetat.h) setEtime (1o.b) 
cputs (conio.h) fte11 (stdio.h) setmode (io.h) 
creat (io.h) ffwrite (stdio.h) setvbuf (stdio.h) 
_creat (io.h) getc (stdio.h) sopen (io.h) 
creatnew (1o.h) getch (conio.h) sprintf (stdio.h) 
creattemp (lo.h) getchar (stdio.h) SSCanf (stdio.h) 
で cscanf (conio.h) getche (conio.h) stat (sys\stat.h) 
dup (to.h) getEtime (io.h) _strerror (5tring.h。 
dup2 (to.h) getpass (conio.h) stdio.h) 
eof (io.h) gets (stdio.h) strerror (string.h) 
fclose (stdio.h) getw (stdio.h) te11 (io.h) 
fc1osea11 (stdio.h) ioct1 (io.h) tmpfile (stdio.h) 
fdopen (stdio.h) 1satty (io.h) tmpnam (stdio.h) 
feof (stdio.h) kbhit (conio.h) ungetc (stdio.h) 
ferror (stdio.h) 1ock (io.h) ungetch (conio.h) 
fflush (stdio.h) 1seek (io.h) unlock (io.h) 
fgetc (stdio.h) 。 _open (Ho.h) vEprintf (stdio.h) 
fgetchar (stdio.h) open (io.h) YEscanf (stdio.h) 
fgetpos (stdio.h) PerrOF (stdio.h) Yprintf (stdlo.h) 
fgets (stdio.h) PFintE (stdio.h) Yscanf (stdio.h) 
filelength (io.h) Putc (stdio.h) Ysprintf (stdio.h) 
Et1eno (stdio.h) putch (stdlo.h) YsscanE (stdio.h) 
flusha11 (stdio.h) putchar (stdlo.h) _wrlte (stdio.h) 
fopen (stdio.h) Pute (stdio.h) write (stdio.h) 


fprintE (stdio.h) 


ライ プラ リル ー チ ン の 分 類 


イン ター フェ ー ス ルー チン (MS-DOS, 8086) : 
MS-DOS, 8086 な ど , マシ ン 特 有 の 機能 を 与え ます 。 


absread (dos.h) getfatd (dos.1) outport (dos.h) 
abswrite (dos.h) getpsp (dos .h) outportp (dos.h) 
bdos (dos .h) getvect (dos .h) Parsfnm (dos.h) 
bdosptr (dos.h) getverify (dos.h) peek (dos .h) 
country (dos.h) barderr (dos.h) peekb (dos.h) 
ctr1brk (dos.h) hardresume (dos.h) poke (dos.h) 
disable (dos.h) hardretn (dos .h) pokeb (dos.h) 
dosexterr (dos.h) 1nport (dos.h) randbrd (dos.h) 
enable 1nportb (dos.b) randbwr 

FP_OFE (dos.h) tnt86 (dos.h) segread 

FP_SEG (dos.h) 1nt86x (dos.h) setcbrk 

freemem (dos.h) 1ntdos (dos.h) setdta 
geninterrupt (dos.h) 1ntdosx (dos.h) setvect (dos.h) 
getcbrk (dos.h) 1ntr (dos.h) setverify (dos.h) 
getdfree (dos.h) keep (dos.h) s1eep (dos.h) 
getdta (dos .h) MK_FP (docs.h) unlink (dos .h) 


getfat (dos.b) 


文字 列 ・ メ モリ 操作 ルー チン : 
文字 列 あ る い は メモ リプ ロッ ク を 操作 する も の で す 。 コ ビ ピー, 比較 、 次 換 、 探索 な ど 
を 行ない ます 。 


memccpy (mem.h, string.h) strchr (string.h) strncmpi (string.h) 
memchr (mem.h,。 string .h) Strcmp (string.h) strncpy (string.h) 
memcmp (mem.h, string.h) strcmp1i (string.h) strnicmp (string.h) 
memcpy (mem.h, string.h) strcpy (string.h) strnset (string.h) 
memicpy (mem.h, string.h) strcspn (string.h) strpbrk (string.h) 
menmove (mem.h, string.h) strdup (string.h) strrchr (string.h) 


memset (mem.h, string.h) Strerror (string.h) strrev (string.h) 
movedata (mem.h, string.h) stricmp (string.h) strset (string・b) 
movmem (mem.h, string.h) strlen (string.h) strspn (string.h) 
setmem (mem.h) Strlwr (string.b) Strstr (string.h) 
stpcpy (string.h) strncat (string.h) strtok (strtng.h) 
strcat (string.h) strncmp (string.h) strupr (string.h) 
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数 学 ル ー チ ン : 


数 学 的 計算 や 変換 を 行なう も の で す 」 

abs (std1ib.h) floor (math.h) pow (math.h) 
acos (math.h) fmod (math.b) pow10 (math.h) 
asin (math.h) fpreset (Eloat.h) rand (std1ib.h) 
atan (math.h) frexp (math.h) random 。 (std1ib.h) 
atan2 (math.h) gcvt (std1ib) random1ze (std11b.h) 
atoE (math.h。 std1ib.h) hypot (math.h) _rot1 (std1ib.h) 
atoi (std1ib.h) itoa (std1ib.h) rotr (std11b.h) 
ato1 (std1ib.h) 1abs (std1ib.h) sin (math.h) 
cabs (math.h) 1dexp (math.h) sinh (math.h) 
cei1 (math.h) 1divy (std1ib.h) sqrt (math.h) 
_c1ear87 (El1oat .h) 1og (math.h) Srand (std1ib.h) 
_contro187 (E1oat.h) 1og10 (math.h) _status87 (E1oat.h) 
Cos (math.h) _1rot1 (stdlib.h) strtod (stdlib.h) 
cosh (math.h) _1rotr (stdlib.h) strtol (std1ib.h) 
div (std1ib.h) 1toa (stdlib.h) strtou1 (stdllb.h) 
ecvt (std1ib.h) _matherr (math.h) tan (math.h) 
exp (math.h) matherr (math.h) tanh (math.h) 
fabs (math.h) modf (math.h) ultoa (std1ib.h) 
fcvt (std1ib.h) poly (math.h) 


メモ リ 割 り 当 て ルー チン : 
スモ ー ル デー タモ デル お よび ラー ジ デ ー タ モデ ル で , 動 的 メモ リ 割 り 当 て を 行なう ル 


ーー ジン ぎす < 

a11ocmem (dos .h) Earmalloc (al1oc.h) 

brk (a11oc .h) farreal1oc (al1oc.h) 

ca11oc (a11oc .h) free (a11oc.h, std1ib.h) 
coreleft (a11oc .h, std1ib.h) ma11oc (a11oc.h。 std11b.h) 
farcal1oc (al11oc.h) rea11oc (a11oc .h,。 std1ib.h) 
farcoreleft (al11oc.h) sbrk (a11oc .h) 

farfree (a11oc .h) setblock (dos.h) 


その 他 の ルー チン : 
ロー カル で な い goto 機能 や 、 ビー プ 音 の 制御 な ど を 与え ます (* は PC-9801 の み の 関 
数 で す )。 


beep * (dos . も ) nosound (dos .h) 
de1ay (dos.h) putuserfont * (dos.h) 
getfont * (dos .h) setjmp (set]jmp.h) 
1ongjmp (setjmp.h) sound (dos.h) 


ライ プラ リル ー チ ン の 分 類 1Z 


プロ セス 制御 ルー チン : 
ある プロ セス の 中 か ら , 新しい プロ セス を 呼び 出し た り 、 終了 させ た りす る も の で す 。 


abort (process.h) atse (signa1.h) 

exec1 (process.h) sgna1 (signa1 .h) 

execle (process.h) spawn1 (process.h) 
execlp (process.h) spawnle (process.h) 
execlpe (process.h) spawnlp (process.h) 
execV (process.h) spawnlpe (process・h) 
execVe (process・.h) SpPawny (process.h) 
execvp (process.h) Spawnve (process.h) 
execvpe (process.h) spavwnyp (process.h) 
_exit (process.h) SpawnVDe (process・h) 
exit (process.h) system (process.h) 

標準 ルー チン : 


これ ら は 標準 ルー チン で 


abort (std1ib.h) (43 (std1ib.h) random (std1ib.h) 
abs (std1ib.h) getenv (std1ib.h) randomize (std1ib.h) 
atexit (std1ib.h) 1toa (std1ib.h) rea11oc (std1ib.h) 
atof (std1ib.h) 1abs (std1ib.h) Fot1 (std1ib.h) 
atoi (std1ib.h) 1find (std1ib.h) _rotr (std1ib.h) 
atol (std1ib.h) ー1rot1 (std1ib.h) srand (std1ib.h) 
bsearch (std1ib.h) _1rotr (std1ib.h) strtod (std1ib.h) 
ca11oc (std1ib.h) 1search (std1ib.h) strtol (std1ib.h) 
ecvt (std1ib.h) 1toa (stdlib.h) strtou1 (stdlib.h) 
exit (std1ib.h) malloc (std1ib.h) swab (stdlib.h) 
exit (std1ib.h) puteny (std1ib.h) System (std1ib.h) 
fcvt (stdlib.h) qsort (std1ib.h) ultoa (std1ib.h) 
free (std1ib.h) rand (std1ib.h) 


テキ スト ウィ ンド ウ 表 示 ル ー チ ン : 
テキ スト ウィ ンド ウ の 制御 と 出力 を 行なう ルー チン で す (* は PC-9801 の み の 関 数 で 
す )。 


c1reo1 (conio.h) movetext (conio.h) textcursor * (conio.h) 
c1rscr (conio.h) normvideo (conio.h) textmode (conio.h) 
de11ine (conio.h) puttext (conio.h) textreverse * (conio.h) 
gettext (conio.h) textatt エ (conio.h) textunder * (conio.h) 
gettextinfo (conio.h) textbackground (conio.h) textvertical1 * (conio.h) 
gotoxy (conio.h) textbank * (conio.h) wherex (conio.h) 
highvideo (conio.h) textb1ink * (conio.h) wherey (conio.h) 
1ns1ine (conio.h) textco1or (conio.h) window (conio.h) 
1owvideo (conio.h) 
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時 刻 お よび 日 付 ル ー チ ン : 


時 刻 変 換 、 時 刻 操作 の ルー チン で す 。 


asctime (time.h) 
ctime (time 1) 
diEEtime (time.h) 
dostounix (dos.h) 
ftime ( sysS\t1mel 


変数 引数 リス トル ー チ ン : 


getdate (dos -h) settime (dos.h) 
gettime (dos .h) stime (time.h) 
gmtime (time .h) time (time.h) 
1oca1time (time.h) tzset (time.h) 
b.h) setdate (dos.h) unixtodos (dos.h) 


Yprintf な どの 中 で , 変数 引数 の リス ト に アク セス する 場合 に 使い ます 。 


Ya_arg 。 (stdarg.h) Ya_end 


BIOS イン ター フェ ー ス (PC-9801) : 
PC-9801 の ROM-BIOS を 呼び 出す ルー チン で す 。 


blos98com 
bios98com_ch2 
bios98com_ch3 
bios98com_init 
bios98com_init_ch2 
blos98com intt_ch3 
blos98disk 
bios98equip 
bios98harddisk 


(bios98.h) 
(bios98.h) 
(bios98.h) 
(bios98.h) 
(bios98.h) 
(bios98.h) 
(btos98.h) 
(bios98. ゎ ) 
(bios98.1) 


BIOS イン ター フェ ー ス (IBM PC) : 
IBM PC の ROM-BIOS を 呼び 出す ルー チン で す 。 


bioscom (bos.h) 
btosdisk (bios.h) 
biosequip (bios.h) 


ライ プラ リル ー チ ン の 分 類 


bioskey 
biosmemory 


(stdarg.h) 。 va_start (stdarg・b) 
bios98key (bios98.h) 
bios98memory (bios98.h) 
bios98mouse (bios98.h) 
bios98mouse_init (bios98.h) 
bios98mew (bios98.h) 
bios98print (bos98.h) 
bios98stoptimer (bos98.h) 
bios98time (bios98.h) 
bios98timer (bios98.h) 
(bios.h) biosptint (bios.h) 
(bos.h) biostime (bios.h) 
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日 本 語 処 理 ル ー チ ン (PC-9801 の み ) : 
日 本 語 対応 の 文字 列 操作 お よび 文字 分 類 ル ー チ ン で す 。 


btom (jstring.h) jishira  (jtype.h) jstrmatch (jstring.h) 
chkctype (jctype.h) jiskana (jtype・1) jstrncat (jstring.h) 
hantozen (jctype・h) jiskata (jtype.h) jstrncmp (jstring.h) 
1salkana (jctype.h) jiskigou  (jtype.b) jstrncpy (jstring.h) 
1salnmkana (jctype.h) js10 (jtype・h) jstrrchr (jstring.h) 
1sgrkana (jctype.h) jis11 (jtype.h) jstrrey 。 (jstcing.h) 
1akana (jctype・h) jis12 (jtype.h) jstrskip (jstrtng.h) 
1skan]1 (jctype.h)  jts1ower  (jtype.h) jetrstr (jstring.h) 
1skan]12 (jctype.h) tsspace  (jtype.h) jstrtok (jstring.h) 
1skmo]i (jctype.h) jistojms (jtype・.h) jtohira (jtype・h) 
1ekpun (jctype.h)  jHsupper  (jtype.h) jtokana (jtype.h) 
1spnkana (jctype・h) jszen (jtype.h) jtokata (jtype・h) 
1eprkana (jctype.h) jmstojis  (jtype.b) jto1ower  (jtype.h) 
jasctime (time .h) jstrady (jstring.h) jtoupper (jtype・h) 
jctime (time .h) jstrchr (jstring.h) mtob (jstring.h) 
jsa1pha (jtype.h) jstrcmp (jstring.h) nthctype  (jtype.h) 
jisdigit (jtype.h) jstr1en (jstring.h) zentohan  (jtype.h) 


サウ ンド ライ プラ リ (PC-9801 の み ) : 
PC-9801 の サウ ンド ポー ド を 操作 する ルー チン で す 。 


mc_b1ock (music.h) mc_inquire (muelc.h) mc_rom (music.h) 
mc_continue (music.h) mc_mode { c.h) mc_scalar (music.h) 
mc_ground (music.h) mc play (music.h) 。 mc_stop (mastc.h) 
mc_inttta11ze (music.h) mcregister (musc.h) 
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main 関数 


C の プロ グラ ム に は , すべ て maim 関数 が な けれ ば な り ま せん (それ を どこ に 置く か は , 
好み の 問題 で すす が )。main を ファ イル の 先頭 に 置く プロ グラ マ も あり , 一 番 最 後に 置く 人 
も いま す 。 し か し , 置か れる 位置 と は 関係 な く , main 関数 に 対し て は , 以下 に 示す よう な 
ポイ ント が 必 ら ず 適 用 され ます 。 


main へ の 引数 


ここ に 示す の は , TurboC スタートアップ ルー チン に よっ て main に 渡さ れる パラ メー 
タ (引数 )、 grgc, grgy。 お よび ezy で す 。 


田 整 数 rgc は 、 main に 渡さ れる コマ ンド ライ ン 引 数 の 個数 で す 。 


罰 gy は 文字 列 へ の ポイ ンタ の 配列 で す 。 

・ バ パー ジョ ン 3.x の MS-DOS で は , gzgy[0] は 実行 され る プロ グラ ム の フル パス と 
し て 定義 され ます 。 

・ バ パージ ョ ン 3.0 未 満 の MS-DOS の 下 で は , grgy[0] は ヌル 文字 列 ("") を 指し ま 
k め の 

・@gy[1] は , MS-DOS の コマ ンド ライ ン で プロ グラ ム 名 の 後に 最初 に タイ プ さ れ 
た 文字 列 を 指し て いま す 。 

・ の gy[2] は , プロ グラ ム 名 の 2 つ 後 に タイ プ さ れ た 文字 列 を 指し て いま す 。 

・ の gy[grgc-1] は 、 main に 渡 き れ た 最後 の 引数 を 指し て いま す 。 

・ の gy[grgc] は NULL に な り ま す 。 


田 ey も 文字 列 へ の ポイ ンタ の 配列 で す 。 ey[] の 各 要 素 は 、 WV レ レ 4 ニ yg/ge の 形式 の 
文字 列 を 指し て いま す 。 
・EW ア 4 は 環境 変数 の 名 前 で , PATH, 87 な ど が あり ます 。 
・ yg7e は と レレ 4 に セッ ト さ れる 値 で 、 た と えば PATH に は A : \DOS:A : 
半 TURBOC な ど が , 87 に は YES な ど が 与え られ ます 。 


main 関 数 21 


TurboC スタートアップ ルー チン は 、 必 ら ず こ の 三 つ の 引数 を main に 渡し ます が , プ 
ログ ラム の 中 で これ ら を 定義 むす る か どう か は プロ グラ マ が 決め る こと が で きま す 。 これら 
の 引数 の 内 の いく つか (ある い は すべ て ) を 宮 言 すれ ば , main ルー チン 内 で ロー カル 変数 
と し て 使え る よう に な り ま す 。 

た だ し , これ ら の パラ メー タ を 宣言 する 場合 は , 必 ら ず , の gc, の gw ey の 順 で 
し な けれ ば な ら な いこ と に 注意 し て くだ さい 。 

以下 に 示す 例 は , main の 引数 の 宣言 と し て 、 い ずれ も 有効 で す 。 


main() 

main(int ar&c) /* 有効 だ が 一 般 的 で は な い */ 

main(int argc, char * acgy[]) 

main(int argc。 char * argv[], char * eny[]) 
注意 1 : 二 番 目 の 宜 言 main(int grgc) は 誤り で は あり ませ ん が , プロ グラ ム 内 で ggy の 
要素 は 使わ ず に gzge を 使う と いう こと で , あま り 一 般 的 で は あり ませ ん 。 


注意 2 : 引数 ey は 、 グロ ー バ ル 変 数 ezproz を 通し て で も 使用 する こと が で きま す 。 こ 
の 章 の ezpfroz の 項 、 お よび 第 2 章 の putenv と geteny の 項 を 見 れ ば . より 詳し い 情 報 が 
得 ら れ ま す 。 


argc, argv,。 envy を 使用 する サン プル プロ グラ ム 


次 に 示す 例 は , main に 渡さ れる これ ら の 引数 を 利用 する 方 法 を ボ す プロ グラ ム (ARGS. 
EXE) で す 。 
プロ グラ ム ARGS.EXE */ 


1nclude <stdio.h> 
1nclude <std1ib.h> 


main(int argc, char *acgv[ ], char *eny[ ]) 
( 
nt ii 
Printf("The value of argc 1s Zd \nwn',argc)s 
PrintE("These are the zd conmand-11ne arguments passed to main: \n を n', 
ar8Cc): 


for (1 = 0: 1 <= argci 1 人 せ ) 
printf(" argv[Xd]: Zswn*。 1。 argy[i]): 


Printf("nThe environment string(s) on this system are:\nn"): 


for (1 = 0: env[i] != NULLi +) 
Printf(" env[zd]: Zen"。 1。 eny[1]): 
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この プロ グラ ム ARGS.EXE を , MS-DOS の プロ ンプ ト か ら 次 の よう な コマ ンド ライ ン 
で 実行 し た と し ます 。 


AiW> arg8 first_argument "argument with blanks" 3 4 "1ast but one" stopi 


この 例 の "argument with blanks" や "last but one" の よう に , 二 重 引用 符 で 囲 め ば , 空 
白 を 含む 引数 も 渡せ る こと に 注意 し て くだ さい 。 

ARGS.EXE の 出力 は , (環境 変数 が ここ に 示す よう に 設定 され て いる と すれ ば ) 次 の よ 
うに な り ま す 。 

The value of argc le 7 


These are the 7 command-1ine arguments passed to main: 


argV[0]: AiWTURBOCWARGS.EXE 
argv[1]: First_argument 
argy[2]: acgument with b1anke 
argv[3]: 3 

argv[4]: 4 

argv[5]: 1ast but one 
argv[6]: stopl 

argy[7]: (nu11) 


The environment string(s) on this system arer 


env[0]: COMSPEC=A:\COMMAND .COM 

env[1]: PROMPTsSpSg 

env[2]: PATHaA:\SPRTNT:A:\DOS:A:\TURBOC 
注意 : main に 渡さ れる コマ ンド ライ ン 全 体 の 最大 の 長 さ は (引数 の 区 切り の 空白 も 含め 
て ) 128 文 字 に な り ま す 。 こ れ は MS.-DOS の 制限 で す 。 


main へ の ワイ ルド カー ド 引 数 


ワー ルド カー ド 文 字 を 含む コマ ンド ライ ン 引 数 は 、 DOS が COPY コマ ンド に 渡さ れ た 
ワイ ルド カー ド を 展開 する の と まっ た く 同 方 法 で , 一 致す る すべ て の ファ イル 名 に 展開 
され る よう に する こと が で きま す 。 ワ イル ドカ ー ド の 展開 に 必要 な こと は , TurboC に 含 
まれ て いる オプ ジェ クト ファ イル WILDARGS.OB] を プロ グラ ム に リン ク す る だ け で す 。 

WILDARGS.0BJ が プロ グラ ムコ ー ド に リン ク さ れ て いれ ば , *.* な どの 形式 の ワイ 
ルド カー ド 引 数 を main 関数 に 送る こと が で きま す 。 ワイ ルド カー ド 引 数 は , (grgy 配列 の 
中 に ) ワイ ルカ ー ド マス ク に 一 致す る すべ て の ファ イル 名 と し て 展開 され ます 。 gygy 配列 
の 最大 サイ ズ は , ヒー プ 中 で 使用 可能 な メモ リ の 量 に よっ て 変化 し ます 。 

一 致す る ファ イル が 見 つか ら な い 場 合 は , 引数 は その まま 渡さ れ ま す (つま り , ワイ ル 
ドカ ー ド を 含む 文字 列 が main に 渡さ れ ます )。 
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例 : 次 の 2 つの コマ ンド は , ファ イル ARGS.C を コン パイ ル し て ワイ ルド カー ド 展 開 モ ジ 
ュー ル WILDARGS.OBJ を リン ク し , 作成 され た 実行 可能 ファ イル ARGS.EXE を 実行 し 
た も の で す 。 


tcc args wi1dargs・ob} 


argSs Ai\TURBOC\TNCLUDE ぜ * 日"*.CT 


ARGS.EXE が 実行 され る と 、 最初 の 引数 は 、 A : 半 TURBOC\INCLUDE ディ レク ト 
リ に ある すべ て の . H ファ イル 名 に 展開 され ます 。 展開 後 の 引 数 文字 列 に は , 完全 な パス が 
含ま れる こと に 注意 し て くだ さい (た と えば A : \TURBOC\INCLUDE\ALLOC. 
H)。2 番 目 の 引 数 *.C は , 引用 符 で 囲ん で ある の で 展開 され ませ ん 。 

統合 環境 (TC.EXE) の 場合 に は , 次 の よ う な 内 容 の プロ ジェ クト ファ イル を 作っ て , そ 
の ファ イル 名 を Project/Project name で 指定 し て くだ さい 。 


ARGS 
WILDARGS.0BJ 


そし て , Options/Arguments オプ ショ ン を 使っ て 、 コ マン ドラ イン 引数 を セッ ト し ま 
す 。 


注意 : いち いち WILDARGS.OBJ を リン ク し な く て も , ワイ ルド カー ド の 展開 が デフ ォ 
ルト で 可能 と な る よう に し た い 場 合 は , 標準 の ライ プラ リフ ァイル Cx.LIB に WILDAR- 
GS.OBj を 組み 入れ て し まう こと が で きま す 。 こ れ を 行なう に は , 標準 ライ プラ リ か ら 
SETARGV モジ ュー ル を 削除 し て , WILDARGS を 追加 し ます 。 次 の コマ ンド は , Turbo 
ライ プラ リア ン TLIB を 呼び 出し て , すべ て の 標準 ライ プラ リ を 変更 し て いま す (これ 
は , 標準 C じ ライ プラ リ と WILDARGS.OBJ が カレ ント ディ レク トリ に ある 場合 で す )。 


t1ib cs -setargv Tewildargs 
t1ib cc -setargv +wildargs 
t1ib cm -setargv wildargs 
t1ib cl1 -setargv +wildargs 
t1ib ch -setargy +wildarge 
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-p オプ ショ ン を 使っ た コン パイ ル 
(Pascal の 呼び 出し 慣例 ) 


Pascal の 呼び 出し 慣例 (ユー ザー ズ ガ イド の 第 12 章 に 詳細 が あり ます ) を 用 いて プログ 
ラム を コン パイ ル す る 場合 は 、 main が C の タイ プ で ある こと を 明示 し て 定 言 し を な けれ ば 
な り ま せん 。 

それ に は , 次 の よう に 予約 語 cdecl を 使い ます 。 


cdec1 main(int argc, char *ar&gy[ ] , char *envyp[ ] ) 


main が 返す 値 


main が 返す 値 は 、 その プロ グラ ム の ステ ー タ スコ ー ド (int) に な り ま す 。 た だ し , プロ 
グラ ム の 終了 に exit ルー チン (ある い は -_exit) を 使う と , main が 返す 値 は exit (も るい 
は _exit) を 呼び 出す と き に 渡さ れ た 引数 の 値 に な り ま す 。 

た と えば , プロ グラ ム が 次 の よう な 呼び 出し を し て いる と , ステ ー タ ス は 1 に な り ま す 。 


exit(1) 


TurboC の 統合 環境 版 (TC.EXE) を 使っ て いる 場合 に は 、 プロ グラ ム の 実行 が 終了 し 
て か ら , Compile メニ ュー の Get info を 選べ ば (GRPF-C, G)、 main か ら の 戻り 値 を 見 
る こと が で きま す 。 

"Function should return a value" (関数 は 値 を 返さ な けれ ば な ら な い ) の 警告 を オン 
に し て いる 場合 (-wrvl また は 0/C/Errors/Common errors/A : .…On)、 そ の チェ ッ ク 
は main 関数 に も 適用 され ます 。main に 対し て この 警告 を 出し た く な けれ ば , return 文 で 
値 を 返す よう に する か , main を 次 の よう に void 型 と 宣言 する よう に し て くだ さい 。 


Yoid main() 
6 
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グロ ー バ ル 変 数 


コ プ ロ セッ サチ ッ プ フラ グ で す 。 


extern int 8087: 


dosh 


変数 8087 は , スタ ー ト アッ プ コ ー ド の 自動 検出 ルー チン が 浮動 小数 点 コ 
プロ セッ サ (8087, 80287、 あ る い は 80387) が 装着 され て いる こと を 検出 
し た 場合 に は 、 0 で な い 値 ( チ ッ プ の 種類 に よっ て それ ぞ れ 1, 2, ある い は 
3) に セッ ト さ れ ま す 。 そ う でない 場合 に は , _808Z7 は 0 に セッ ト さ れ ま 
す 。 

自動 検出 機能 は , 環境 変数 87 を YES また は NO に セッ ト す る こと に よっ 
て 無効 に する こと が で きま す (DOS の プロ ンプ ト か ら SET 87= ニ YES ある 
い は SET 87= ニ NO と いう コマ ンド を 与え ます 。 等 号 の 前 後に スペ ー ス を 入 
れ て は いけ ませ ん )。 こ の 場合 に は _808Z の 値 は , 環境 変数 の 値 に し た が っ 
て 1(YES) また は 0(NO) に セッ ト され ます 。 

環境 変数 57 に つい て は , ユー ザー ズ ガ イド の 第 12 章 を 参照 し て くだ さい 。 
プロ グラ ム 内 に 浮動 小数 点 コ ー ド が 含ま れ て いる 場合 , 8087 は 適切 な 
値 (1-3) に セッ ト さ れ て いな けれ ば な り ま せん 。 
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_ 7 の C 


機能 コマ ンド ライ ン 引 数 の 個数 を 保持 し て いま す 。 


形式 extern int grgc: 


宣言 ファ イル dosh 


解説 _e7 み c は 、 プ ログ ラム グ の 実行 開始 時 に main に 渡さ れ た gc の 値 を 持っ て 
いま す 。 

_ の 7 の ひ 

機能 コマ ンド ライ ン 引 数 へ の ポイ ンタ の 配列 で す 。 

形式 extern char *※ grgyl] : 


宣言 ファ イル dosh 


解説 _g@79 の の は 、 プロ グラ ム の 実行 開始 時 に main に 渡さ れ た も と も と の コマ ン 
ドラ イン 引数 (grgy[] の 要素 ) を 持つ 配列 を 指し て いま す 。 


グロ ー バ ル 変 数 2Z 


し /7477/77//74 


機能 夏時間 が 有効 か どう か を 示し て いま す 。 

形式 extern int gyjgZr: 

宣言 ファ イル timeh 

解説 gdgg7 が の 7 は, 時 刻 日 付 関数 に よっ て 使用 きれ ます 。 
ggg7igf は , tzset, ftime お よび localtime 関数 に よっ て , 夏時間 の 実施 
期間 中 で あれ ば 1, 標準 時 間 中 で あれ ば 0 に セッ ト さ れ ま す 。 

の 77ec7 の 7 の eo 

機能 ビデ オ 出 力 を 制御 よる フラ グ で す 。 

形式 extern int gyecneo 

宣言 ファ イル timeh 

解説 @7ecf の geo は 、 プ ログ ラム の コン ソー ル 出 力 (cputs な ど に よる も の ) 
が , 直接 ビデ オォ RAM に 書き 込ま れる (gecf が geo 三 1) か 、ROM BIOS 
を 通じ て 送ら れる (gzrecfozgeo 三 0) か を 制御 し て いま す 。 
デフ ォ ル ト 値 は @recf の deo 王 1 で , コン ソー ル 出 力 は ビデ オォ RAM に 直 
接 送 られ ます 。 gzsrecfozdeo 王 1 と し て 使用 する 場合 に は 、 シ ステ ム の ビ 
デオ ハー ドウ ェ ア は , IBM の ディ スプ レイ アダ プ タ と 完全 な 互換 性 が な け 
れ ば な り ま せん 。 geczpzeo 王 0 に モッ ト し て いる 場合 に は , コン ソー 
ル 出 力 は IBM BIOS と コン パチ ブル な すべ て の シス テム で 動作 し ます 。 
注意 : PC 一 9801 用 で は , grec の geo は 宣言 は され て いま す が , まっ た く 
使用 きれ て いま せん 。 
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672 の 77072 


機能 


形式 


宣言 ファ イル 


グロ ー バ ル 変 数 


DOS の 環境 変数 へ の アク セス で す 。 


extern char * enyyoz[]: 


dos.h 


ezozroz は 文字 列 へ の ポイ ンタ の 配列 で .、 プロ セス の 環境 に アク セス し た 
り , 環境 を 変更 し た りす る 場合 に 使用 し ます 。 各 文字 列 は 次 の よう な 形式 
に な っ て いま す 。 


Yarname = Varvalue 


ye797e は 環境 変数 の 名 前 (PATH な ど )、 vgzyg7e は 環境 変数 ( yZzg7ze) 
に セッ ト さ れ て いる 値 (A : ま BIN:A : DOS な ど ) で す 。 文字 列 grvg/we 
は 空 の 場合 も あり ます 。 

プロ グラ ム の 実行 開始 時 に 、 MS-DOS の 環境 設定 は 、 直接 その プロ グラ ム 
に 渡さ れ ま す 。 main へ の 3 番目 の 引数 ez は , ezoproz の 初期 設定 と 同じ 
で ある こと に 注意 し て くだ さい 。 

ez の roz 配列 は 、getenv 関数 に よっ て アク セス する こと が で きま す が , 配 
列 ezpzroz の 要素 の , 追加 、 変更 , 削除 が 行 な を る の は puteny 関数 だ け 
で す 。 こ れ は , 修正 に よっ て プロ セス 環境 変数 の 大 き さ が 変更 され た り , 
再 配置 され た り し て も , ezozroz は 自動 的 に 調整 され て その 配列 を 指し て 
いる よう に する た めで す 。 
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677720。 の OS677720, SS 677/7S/。 SS 767 ア 


機能 perror が エラ ー メ ッ セ ー ジ を プリ ント する こと を 可能 に し ます 。 


形式 extern int er/7O: 
extern int doserr7 の : 
extern char * SWS er な 


extern int SMS 7e/7: 


宣言 ファ イル errno.h, stdlib.h (eryzzo, goserrzO, 8 の 8 677/ZS7。 8 の 8_ 7677) 
dos.h ( goseryrzzo) 


解説 ery7zO、8 の 8_@777zs た ss zerr7 は 、 ラ イブ ラリ ルー チン が 指定 され た タス 
ク が 実行 で き な か っ た と き に ., perror 関数 が エラ ー メ ッ セ ー ジ を 出力 する 
た め に 使用 し ます 。_goseryzo は 、 多く の DOS エラ ー コ ー ド を eryzo に 
対応 させ る 変数 で す 。 た だ し 、 perror が gdoseyyzo を 直接 使用 する こと は 
あり ませ ん 。 


_goseryzo : DOS シス テム コー ル が エラ ー と な っ た 場合 、 goseryzzo に 
は , DOS の 実際 の エラ ー コ ー ド が セッ ト さ れ ま す 。 ezzzo は 、 ほ ば 同様 な 
変数 で す が , UNIX シス テム か ら 引 き 継 いで いる も の で す 。 


er7zO: シス テム コー ル で エラ ー が 起こ っ た 場合 , err7zo は エラ ー の タイ 
プ を 示す よう に セッ ト さ れ ま す 。errzo が goseryzzo と 同じ こと も あり ま 
す が , errzo に は MS-DOS の エラ ー コ ー ド が 含ま れ な い (_goser7zO に は 
含ま れ て いる ) こと も あり ます 。 ま た 逆 に , errzzo だ けが セッ ト さ れ て , 
_goserrzzo は セッ ト さ れ な いり 場合 も あり ます 。 


sg8_errzs7: メッ セー ジ の 書式 を 制御 する た め に , メッ セー ジ 文 字 列 の 配 
列 が , sgs_err77s を と し て 与え られ て いま す 。 ezyzzo は この 配列 の 添字 と し 
て 使わ れ , エラ ー 番 号 に 対応 する 文字 列 を 見 出す こと が で きま す 。 文字 
列 に は 改行 文字 は 含ま れ て いま せん 。 
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グロ ー バ ル 変 数 


s の 5 err : この 変数 は ss_err/zs7 内 に 含ま れ て いる エラ ー メ ッ セ ー ジ 
の 個数 と し て 定義 きれ て いま す 。 


以下 に 示す の は 、 sgs_err7Zsf 内 に 格納 され て いる 値 に 対す る ニー モニ ッ 


ク と その 意味 で す 。 
ニー モニ ッ ク 意味 
E2BIG 引数 リス ト が 長 す ぎる 
EACCES アク セス 権 が 無い 
EBADF ファ イル 番号 が 正しく な い 
ECONTR メモ リプ ロック が 壊れ て いる 
ECURDIR カレ ント ディ レク トリ を 削除 し よう と し た 
EDOM 定義 域 エ ラー 
EEXIST ファ イル は す て に 存在 し て いる 
EINVACC アク セス コー ド が 正しく な い 
EINVAL 引数 が 正しく な い 
EINVDAT デー タ が 正しく な い 
EINVDRV 指定 され た ドラ イブ が 正しく な い 
EINVENV 環境 が 正しく な い 
EINVFMT 書式 が 正しく な い 
EINVFNC ファ ンク ショ ン 番 号 が 正しく な い 
EINVMEM メモ リプ ロッ クア ドレ ス が 正しく な い 
EMFILE オー プン ファ イル が 多 す ぎる 
ENMFILE これ 以上 の ファ イル は な い 
ENODEV その デバ イス は 存在 し な い 
ENOENT その ファ イル ある い は ディ レク トリ は 存在 し な い 
ENOEXEC exec 書式 エラ ー 
ENOFILE その ファ イル ある い は ディ レク トリ は 存在 し な い 
ENOMEM メモ リ が 足り な い 
ENOPATH パス が 見 つか ら な い 
ENOSPC UNIX で ある 一 DOS で は な い 
ENOTSAM 同一 の デバ イス で は な い 
ERANGE 値 域 エ ラー (結果 が 指定 の 範囲 を 越え た ) 
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クロ ス デ バイ スリ ンク 


エラ ー0 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


に 示す の は _goserrzo に セッ ト され る 実際 の MS-DOS の エラ ー コ ュー 
ド に 対す る ニー モニ ッ ク で す 。 goserrzo は , eryzzo を 通じ て 、 S の 8 er7r7/zs7 
肉 の エラ ー メ ッ セ ー ジ 文字 列 に 対応 づけ され る 場合 と 。 され な い 場 合 が あ 


り ま す 。 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


ニー モニ ッ ク 


意味 


EINVAL 
E2BIG 
EACCES 
EACCES 
EACCES 
EBADF 
EFAULT 
EINVAL 
EMFILE 
ENOENT 
ENOEXEC 
ENOMEM 
ENOMEM 
ENOMEM 
EXDEV 
EXDEV 


無効 な ファ ンク ショ ン 

不正 な 環境 

アク セス は 否定 され て いる 

無効 な アク セス 

カレ ント ディ レク トリ で ある 

無効 な ハン ドル 

(予約 され て いま す ) 

無効 な アー タ 

オー プン され て いる ファ イル が 多 す ぎる 
その よう な ファ イル また は ディ レク トリ は な い 
不正 な フォ ー マ ッ ト 

メモ リコ ント ロー ルプ ブロ ッ ク が 破壊 され て いる 
メモ リ が 不足 し た 

無効 な メモ リプ ロッ ク 

無効 を な ドラ イブ 

同じ デバ イス で は を い 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


DOS の エラ ー リ ター ンコ ー ド に つい て は , MS-DOS プロ グラ マー ズリ フ 
ァ レ ンス マニ ュ ア ル に より 詳し い 情 報 が あり ます 。 
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第 1 章 Turbo C テ ライ プラ リル ー チ ン を 使う 


_ ガ oe 


機能 


形式 


宣言 ファ イル 


グロ ー バ ル 変 数 


デフ ォ ル ト の ファ イル 変換 モー ド を 決定 し ます 。 
extern unsiged /7oge: 
fcntlh 


_7 が zo9e は 、 フ ァイル が どの モー ド (テキ スト また は バイ ナリ ) で オー プン 
され , 変換 が 行なわ れる か を 決め る も の で す 。 が zoge の 初期 値 は O 
TEXT で あり , この 場合 ファ イル は テキ スト モー ド て で 読ま れ ま す 。 zode 
が O_BINARY に セッ ト さ れる と , ファ イル は バイ ナリ モー ド で オー プン 
され , 読ま れ ま す (O_TEXT と O BINARY は , fcntl.h の 中 で 定義 され て 
いま す )。 

テキ スト モー ド で は , 入力 時 に , CR/LF の ペア は LF1 文 字 に 変換 され ま 
す 。 出 力 時 に は その 逆 の 変換 が 行なわ れ , LF は CR/LF に 変換 され ます 。 
バイ ナリ モー ド で は この よう な 変換 は 行なわ れ ま せん 。 


ライ プラ リル ー チ fopen、fdopen. お よび freopen の 引数 pe に , "も "( テ 
キス トモ ー ド ) また は "b" (バイ ナリ モー ド ) を 指定 すれ ば , _ 婦 zoge に よ 
っ て セッ ト さ れ て いる デフ ォ ル ト の モー ド は 無効 に する こと が で きま す 。 
また , ライ プラ リル ー チ ン open で も , 引数 gceesy に O BINARY また は 
O_TEXT を 指定 すれ ば open の 引数 pg7 ヵ ge で 示さ れ た ファ イル を , 
バイ ナリ モー ド , テキ スト モー ド ど ちら で オー プン する か を 決め る こと が 
で きま す 。 
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_ eg の /e7 


機能 ヒー プ サ イ ズ を 保持 し て いま す 。 
形式 extern unsigned eg//ez ・ 
解説 _egp/ex は 、 スモ ー ル デー タモ デル (タイ ニ ィ , スモ ー ル , ミディ アム ) 


で は , near ヒー プ の サイ ズ を 示し て いま す 。 ラ ー ジ デー タモ デル (コンパ 
クト , ラー ジ 、 ヒュ ー ジ ) で は near ヒー プ が な いた め , _Aegp/ez も 存在 
し ませ ん 。 

スモ ー ル お よび ミディ アム モデ ル で は , デー タ セ グ メ ント の サイ ズ は 次 の 
よう に し て 計算 きれ ま す 。 


デー タ セ グ メ ント [スモ ー ル , ミディ アム ] 
ニ グロ ー バ ル デ ー タ 十 ヒー プ 十 スタ ッ ク 


ここ で , スタ ッ ク サ イズ は _s/ez に よっ て 調整 すみ こと が で きま す 。 


_egp/en が 0 に セッ ト さ れ て いる 場合 は 、 プ ログ ラム は デー タ セ グ メ ント 
に 64K バイ ト を 割り 当て , ヒー プ の 実効 サイ ズ は の よう に な り ま す 。 


64K - (グロ ー バ ル デ ー タ 十 スタ ッ ク ) バイ ト 


デフ ォ ル ト で は _Aegp/ez 三 0 な の で ,_Aegp/ez に な ん ら か の 値 を 指定 し な 
けれ ば , 64K の デー タ セ グ メ ント が 得 ら れる こと に な り ま す 。 
タイ ニ ィ モデ ル で は コー ド も 含め た すべ て が 同一 の セグ メン ト に 置か れ 


る の で , デー タ セ グ メ ント は , コー ド と , プロ グラ ム セ グ メン ト プ レ フィ 
クス (PSP) の 256 バ イト を 含む 長 さ に 調整 され ます 。 


デー タ セ グ メ ント = 256 十 コー ド 十 グロ ー バ ル デ ー タ 
十 ヒー プ 十 スタ ッ ク 
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グロ ー バ ル 変 数 


タイ ニ ィ モデ ル で Aegp/ez 三 0 の 場合 、 ヒ ー プ の 実効 サイ ズ は , 64K か ら 、 
PSP、 コード, グロ ー バ ル デ ー タ 。 お よび スタ ッ ク を 引い た も の に な り ま 
す 。 

コン パクト お よび ラー ジ モ デ ル で は , near ヒー プ は 存在 し な い の で , デー 
タ セ グ メ ント は 次 の よう に 単純 に 求め られ ます 。 


デー タ セ グ メ ント = ニ グロ ー バ ル デ ー タ 十 スタ ッ ク 


ヒュ ー ジ モデ ル で は , スタ ッ ク は 別個 の セグ メン ト に と られ , 各 モ ジュ ー 
ル は モジ ュー ル ご と に デー タ セ グ メ ント を 持ち ます 。 


_8f た 7ez 
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_0S7727707。 0S7727740 た 


機能 


宣言 ファ イル 


DOS の バー ジョ ン 番 号 の メジ ャ ー 部 お よび マイ ナー 部 を 保持 し て いま す 。 


extern unsigned char oszzg7Or ・ 


extern unsigned char osz7Or・ 


dosh 


DOS バー ジョ ン の メジ ャ ー 部 と マイ ナー 部 は 、 _os7xg7O7r と _o87277407 に 
よっ て 別々 に 得る こと が で きま す 。 メ ジャ ー バ ー ジ ョ ン 番 号 が _os7a7or 
に , マイ ナー バー ジョ ン 番 号 が _osmxgzor に 入っ て いま す 。 

これ ら の 変数 は , MS-DOS の バー ジョ ン 2.x と 3.x の 両方 で 走る モジ ュー 
ル を 必要 と する 場合 に 便利 で す 。 ラ イプ ラリ ルー チン の 中 に は , MS-DOS 
の バー ジョ ン に よっ て 動作 が 異な る も の が いく つか あり , バー ジョ ン 3.x 
の 下 で し か 動作 し な いも の も あり ます (第 2 章 の , open, creatnew、ioctl 
の 項 を 参照 し て みて くだ さい )。 


_ の 8 の 


機能 


形式 


宣言 ファ イル 


解説 
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PSP の セグ メン ト ア ドレ ス を 保持 し て いま す 。 
extern unSigned nt の の ・ 
dos.h 


_psp は , 現在 の プロ グラ ム に 対す る プロ グラ ム セ グ メン ト プ レ フィ クス 
(PSP) の セグ メン ト ア ドレ ス を 保持 し て いま す 。 PSP は DOS の プロ セス 
ディ スク リプ タ で あり , プロ グラ ム に つい て の DOS の 初期 情報 を 含ん で 
いま す 。 

PSP に 関す る 詳細 な 情報 に つい て は , MS-DOS プロ グラ マー ズリ ファ レ 
ンス マニ ュ ア ル を 参照 し て くだ さい 。 
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_s 災 /e 


名 前 


形式 


宣言 ファ イル 


解説 


参照 項目 


グロ ー バ ル 変 数 


スタ ッ ク サ イズ を 保持 し て いま す 。 


extern unsigned 3 ・ 


dos.h 


_s 災 ez は 、 6 つの メモ リモ デル の すべ て に お いて , ス タッ クサ イズ を 示し 
て いま す 。 ス タック の 最小 サイ ズ は 128 ワ ー ド で , これ より 小さ い 値 を 与え 
る と ,_s 災 /ez は 自動 的 に 規定 の 最小 値 に 調整 され ます 。 デ フォ ルト の スタ 
ッ ク サ イズ は 4K で す 。 

スモ ー ル お よび ミディ アム モデ ル で は , デー タ セ グ メ ント の サイ ズ は 次 の 
よう に し て 計算 され ます 。 


デー タ セ グ メ ント ニー グロ ー バ ル デ ー タ 十 ヒー プ 二 スタ ッ ク 


ここ で , ヒー プ の サイ ズ は _Aegp/ez を 使っ て 調整 すみこ と が で きま す 。 
タイ ニ ィ モデ ル で は , コー ド も 含め た すべ て が 同一 の セグ メン ト に 置か れ 
る の で , デー タ セ グ メ ント は , コー ド と , プロ グラ ム セ グ メン ト プ レ フィ 
クス (PSP) の 256 バ イト を 含む 長 さ に 調整 され ます 。 


デー タ セ グ メ ント = 256 十 コー ド 二 グロ ー バ ル デ ー タ 
十 ヒー プ 十 スタ ッ ク 


コン バク ト お よび ラー ジ モ デ ル で は , near ヒー プ は 存在 し な い の で , デー 
タ セ グ メ ント は 次 の よう に 単純 に 求め られ ます 。 


デー タ セ グ メ ント ニー グロ ー バ ル デ ー タ 十 スタ ッ ク 


ヒュ ー ジ モデ ル で は , スタ ッ ク は 別個 の セグ メン ト に と られ , 各 モ ジュ ー 
ル は モジ ュー ル ご と に デー タ セ グ メ ント を 持ち ます 。 


_ ん egp/ez 


3Z 


777262Z0726 


機能 ロー カル 時 刻 と GMT と の 差 を 秒 単 位 で 保持 し て いま す 。 

形式 exterm long 74ezoze : 

宣言 ファ イル timeh 

解説 gzezoze は 、 時 刻 日 付 関数 に よっ て 使用 きれ ます 。 
この 変数 に は tzset 関数 に よっ て 計算 され た 値 が 入り ます 。 す な わ ち , ロー 
カル 時 刻 と グリ ニッ ジ 標 準 時 (GMT) と の 差 を 秒 単位 で 表わし た も の が , 
long 型 の 値 と し て 代入 され ます 。 

2747726 

機能 時 間 帯 名 へ の ポイ ンタ の 配列 で す 。 

形式 extern char * gie[2] : 

宣言 ファ イル timeh 

解説 グロ ー バ ル 変 数 zzg7xe は 、 時 間 帯 名 の 略称 を 含む 文字 列 へ の ポイ ンタ の 
配列 で す 。 
な zie[0] は , TZ 環境 文字 列 か ら 取 り 出 し た 地方 時 間 帯 名 の 3 文字 の 文字 
列 を 指し て いま す 。 zzg7ze [1] は, TZ 環境 文字 列 か ら 取り 出し た 夏時間 地 
方 時 間 帯 名 を 表わす 3 文字 の 文字 列 を 指し て いま す 。 夏 時 間 和 帯 名 が 無い 場合 
に は , gze7ze[1] は ヌル 文字 列 を 指し ます 。 
第 2 章 の tzset 関数 の 解説 も 参照 し て くだ さい 。 
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_ の @7S7O74 


グロ ー バ ル 変 数 


DOS の バー ジョ ン 番 号 を 保持 し て いま す 。 
extern unSigned int yersjo/ ・ 
dosh 


_ge7szoz は MS-DOS の バー ジョ ン 番 号 を 含ん で お り , メジ ャ ー バ パー ジョ 
ン が 低位 バイ ト に 、 マイ ナー バー ジョ ン が 高位 バイ ト に 格納 され ます 。 

MS.DOS の バー ジョ ン 番 号 "* ッ "の x が メジ ャ ー バ パ バージョン, 了 が マイ ナ 
ー バ パー ジョ ン で す 。 

これ ら の 変数 は , MS-DOS の バー ジョ ン 2.x と 3.x の 両方 で 走 あ る モジ ュー 
ル を 必要 と する 場合 に 便利 で す 。 ラ イプ ラリ ルー チン の 中 に は , MS-DOS 
の バー ジョ ン に よっ て 動作 が 異な る も の が いく つか あり , バー ジョ ン 3.x 
の 下 で し か 動作 し な いも の も あり ます (第 2 章 の , open、creatnew, ioctl 
の 項 を 参照 し て みて くだ さい )。 
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第 2 章 


Turbo C ラ イブ ラリ 


この 章 で は , Turbo C ラ イプ ラリ 中 の 各 関 数 の 詳細 な 解説 を 行なっ て いま す 。 

な お , テキ スト ビデ オラ イプ ラリ , グラ フィ ックス ライ プ ブラリ, BIOS サポ ー ト ライ ブラ 
リ , 日 本 語 処理 ライ プラ リ , サウ ンド ライ ブラ リ に つい て は , Turbo C 標準 ライ プラ リ と 
は 別に , それ ぞ れ 節 を わけ て 解説 し て あり ます 。 

肉 に 示し た の は , この 章 を どの よう に 使え 々 ば よい か を 示す た め の サ ンプ ル で す 。 


機能 その ルー チン が 何 を 行なう か の 要約 で す 。 
形式 #include <header.h> 


(ヘッ ダフ ァイル に は , 関数 の プロ ト タイ プ や , その 関数 で 使用 され る 定 
数 お よび 列挙 型 デ ー タ な どの 定義 が 含ま れ て いま す 。 #include 文 は 。 そ の 
関数 の 呼び 出し に 際 し て 必要 な 場合 に の み 示し て いま す )。 
routine(modifier pgrgzzerer [,... ] ) : 

(その 関数 の 宣言 の 形式 で す 。 パ ラメ ー タ 名 は イタ リッ ク ( 斜 字 体 ) で 書 
か れ て いま す 。[,.….] は , それ 以降 に 他 の パラ メー タ を 指定 し て も よい こ 
と を 示し て いま す )。 

プロ ト タ イ プ headerh 


(その 関数 の プロ ト タイプ を 含ん で いる ヘッ ダフ ァイル 名 で す 。 い くつ か 
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戻り 値 


可 搬性 


関連 項目 
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の 関数 の プロ ト タ イ プ は , 複数 の ヘッ ダフ ァイル に 含ま れ て いま す が , そ 
の 場合 に は それ ぞ れ を 記し て あり ます )。 


ここ で は , その 関数 が 何 を 行なう の か , どの よう な パラ メー タ を と る の か , 
また , その 関数 お よび 関連 する ルー チン を 使用 する 際 に 必要 と な る 事柄 に 
つい て 説明 し て いま す 。 


その 関数 が 返す 値 が ある 場合 に は ここ で 示し ます 。 その 関数 が グロ ー バ ル 
変数 errzo を セッ ト す る 場合 は それ に つい て も 述べ ます 。 


その 関数 を 使用 で きる シス テム お よび 処理 系 を 示し ます 。 こ れ に は , 
UNIX、PC-9801 あ る い は IBM PC お よび その 互換 機 。、ANSI C な ど が 含 
まれ ます 。 


その 関数 に 関連 し て 参照 する と よい ルー チン を 示し ます 。 こ こ に あげ た 関 
数 名 に ピリ オド 3 つの 省略 記号 が 含ま れ て いる と き は (exec.…… な ど ), その 
ルー チン は ファ ミリ ィ を な し て いる こと を 意味 し て いま す 。 


その 関数 を どの よう に 使え ば よい か を 示す サン プル プロ グラ ム が 載っ て い 
る も の も いく つか あり ます 。 
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Turbo C 標準 関数 リフ ァ レ ンス 


abort 
機能 プロ セス を 異常 終了 させ ます 。 
形式 void abort(void) ・ 


プロ ト タ イ プ stdlib.h、process.h 


解説 abort 関数 は , 終了 メッ セー ジ (Abnormal program termination) を 57e み 
に 出力 し 、 終了 コー ド 3 で exit を 呼び 出し て , プロ グラ ム を 異常 終了 させ 
ます 。 

戻り 値 abort その も の に は 戻り 値 は あり ませ ん が , abort に よっ て ブログ ラム を 


終了 させ る と , 親 プ ロ セ ス ま た は DOS に 3 を 返す こと に な り ま す 。 


可 搬性 abort は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 


関連 項目 assert、 atexit。 exit、 exit、 raise, Signal, spawn.… 


Turbo C 標 準 関数 リフ ァ レ ンス 


43 


abs 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 
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整数 の 絶対 値 を 返し ます 。 


#include <math.h> 
int abs(int *) ・ 


math.h, stdlib.h 


abs は , 整数 引数 * の 絶対 値 を 返し ます 。 stdlib.h が イン クル ー ド され て い 
る と き は , abs は マク ロ と し て 扱わ れ , イン ライ ンコ ー ド に 展開 され ます 。 
abs を マク ロ で は な く 関 数 と し て 扱い た い 場 合 は , プロ グラ ム の 中 に 次 の 1 
行 を 入れ て お きま す 。 


#undef abe 


これ は , #include <stdlib.h> の 後に 書い て くだ さい 。 


abs は , 0 一 32767 の 男 囲 の 整数 を 返し ます 。 た だ し , 引数 が -32768 の 場合 は 
-32768 が 返さ れ ま す 。 


abs は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 


cabs, fabs, labs 
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absread 


機能 ディ スク セク クタ を 直接 読み 込み ます 。 
形式 int absread(int み ijye, int zsecs, int な ecr, void * 77e/) : 


プロ ト タ イ プ dos.h 


解説 absread は , 指定 され た ディ スク セク タ を 読み 込み ます 。 これ は , ディ スク 
の 論理 的 構造 を 無視 し , ファ イル , FAT, ディ レク トリ を 考慮 し ませ ん 。 
absread は , DOS 割り 込み 0x25 を 通し て , 指定 し た ディ スク の セク タ を 読 
みろ 込み ます 。 


み ye 王 読み 込む せ ド ライ ブ 番 号 (0 ニ A、1=B,・・・) 

25ecs 三 読み 込む セク タク 数 

な ecr = 読み 込み を 開始 する 論理 セク タ 番 号 

77er = 読み 込ま れる デー タ が 格納 され る 領域 の 先頭 アド レス 


指定 され た セク タ 数 は , 77er が 指す セグ メン ト 内 の メモ リ 量 に よっ て 制 
限 を 受け ます 。 し た が っ て , absread の 1 回 の 呼び 出し て 読み 込め る 最大 の 
デー タ 量 は 64K バイ ト と いう こと に な り ま す 。 

戻り 値 読み 込み が 成功 し た 場合 absread は 0 を 返し ます 。 
エラ ー が あっ た 場合 は -1 を 返し , erryzo に は シス テム コー ル が 返し た AX 
レジ スタ の 値 が セッ ト さ れ ま す 。errzo の 意味 に つい て は , MS-DOS の プ 
ログ ラマ ー ズ マニ ュ ア ル を 参照 し て くだ さい 。 


可 搬性 absread は MS-DOS に 特有 の 関数 で す 。 


関連 項目 abswrite, bios98disk, biosdisk 
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abswrite 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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ディ スク セク クタ に 直接 書き 込み を 行ない ます 。 
int abswrite(int みみ ipe, int zsecs, int sec void * ネ 2z77ey) : 


dos.h 


abswrite は , 指定 され た ディ スク セク タ に 書き 込み を 行ない ます 。 こ れ 
は , ディ スク の 論理 的 構造 を 無視 し , ファ イル , FAT, ディ レク トリ を 考 
慮 し ませ ん 。 


注意 : 適切 に 使用 きれ な か っ た 場合 、abswrite は .、 ファ イル, ディ レク ト 
リ ,。 お よび FAT を 上 書き し て 壊し て し まう こと が あり ます 。 


abswrite は 、 DOS 割り 込み 0x26 で , 指定 し た ディ スク の セク タ に 書き 込み 
を 行ない ます 。 


の pe 三 書き 込む せ ド ライ ブ 番 号 (0=A, 1= ニ B, ・・・) 

75ec 三 書き 込む セク タク 数 

な ec7 三 書き 込み を 開始 する 論理 セク タ 番 号 

0477er 三 書き 込ま れる デー タ が 格納 され る 領域 の 先頭 アド レス 


書き 込ま れる た セク タ 数 は , が 7er が 指す セグ メン ト 内 の メモ リ 量 に よっ 
て 制限 を 受け ます 。 し た が っ て , abswrite の 1 回 の 呼び 出し で 書き 込め る 最 
大 の デー タ 量 は 64K バイ ト と いう こと に な り ま す 。 


書き 込み に 成功 し た 場合 , abswrite は 0 を 返し ます 。 
エラ ー が あっ た 場合 は -1 を 返し , er7zzo に は シス テム コー ル が 返し た AX 
レジ スタ の 値 が セッ ト され ます 。ezyzzo の 意味 に つい て は , MS-DOS の プ 


ログ ラマ ー ズ マニ ュ ア ル を 参照 し て くだ さい 。 


abswrite は MS-DOS に 特有 の 関数 で す 。 
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関連 項目 absread、 bios98disk、 biosdisk 


Turbo 標準 関数 リフ ァ レ ンス 


47 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 一 


8CCCSS 


機能 


形式 


プロ ト タ イ プ 


戻り 値 
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ファ イル の アク セス 権 を 決定 し ます 。 


int access (const char * 7ezg7ze, int gge) : 


io.h 


access は 、/7/ezgzze で 指定 され た ファ イル を チェ ッ ク し て , その ファ イル 
が 存在 する か どう か , 読み 込み が 可能 か どう か , 書き 込み が 可能 か どう か , 
また 実行 可能 か どう か を 調べ ます 。 

@ の 7499e が 示す ビッ トバ パターン は , 次 の よう な 意味 を 持ち ます 。 


06 読み 込み と 書き 込み 許可 の チェ ッ ク 

04 読み 込み 許可 の チェ ッ ク 

02 書き 込み 許可 の チェ ッ ク 

01 実行 の チェ ッ ク (無視 され ます ) 

00 "ファ イル が 存在 し て いる か どう か の チェ ッ ク 


注意 : MS-DOS で は すべ て の ファ イル が 読み 込み 可能 で す (oge= ニ 
04)。 し た が っ て 00 と 04 は 同じ 結果 に な り ま す 。 同様 に , MS-DOS で は 書き 
込み 可能 な ら ば 自動 的 に 読み 込み 可能 と な る の で , 06 と 02 は 等 し い 意味 を 
持つ こと に な り ま す 。 


7 が ezgze が ディ レク トリ の 場合 は , access は 単に その ディ レク トリ が 存在 
し て いる か どう か を チェ ッ ク し ます 。 


指定 され た アク セス 権 (gzxoge に 指定 し た 値 ) が 許さ れ て いる 場合 は 0 を 返 
し ます 。 そ う でない 場合 は -1 を 返し , eryzo に 次 の よう な 値 を セッ ト し ま 
す 》 


ENOENT パス 名 ある い は ファ イル 名 が 見 つか ら な か っ た 
EACCES 許可 きれ て いな い 
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可 搬性 access は UNIX シス テム で 使用 てき ます 。 
関連 項目 chmod、fstat、 stat 


例 1nc1ude <stdio.h> 
ま #1nclude <io.h> 


/* ファ イル 名 が 存在 すれ ば 1 を 返し , 存在 し な けれ ば 0 を 返す */ 


1nt fle_exists(char *f11ename) 
{ 

return (access(f11ename。 0) == 0): 
} 


matn() 
{ 
printf(*Does NOTEXTST.FTL exlet: Zs\Wn'。 
fi1e_exists(*NOTEXTST.FTL") 7 "YES" : "NO")i 


プロ グラ ム 出 力 
Does NOTEXIST.FTL existi: NO 
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COS 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬 性 


関連 項目 
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逆 余弦 を 求め ます 。 


#include <math.h> 


double acos(double *) : 


math.h 

acos は , 入力 値 の 逆 余弦 (アー クコ サイ ン ) を 返し ます 。 引 数 * は ,-1 か 
ら 1 の 間 に な けれ ば な り ま せん 。 こ の 範囲 外 の 値 を 引数 と し て 与え る と , 
acos は 0 を 返し , eryzo に EDOM (定義 域 エ ラー) を セッ ト し ます 。 
acos は 、 0 一 ァ の 値 を 返し ます 。 

この 関数 に 対す る エラ ー 処 理 は , 関数 matherr を 使っ て 変更 する こと が で 
きま す 。 


acos は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 


asin、 atan, atan2, cos、 cosh、 matherr、 sin、 sinh、tan, tanh 
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allocmem 


機能 DOS の メモ リセ グ メ ント を 割り 当て ます 。 


形式 int allocmem (unsigned sze, unsigned * segp) : 


プロ ト タ イ プ dosh 


解説 allocmem は , DOS の シス テム コー ル 0x48 を 使っ て フリ ー メ モリ の プロ ッ 
ク を 確保 し , その セグ メン ト ア ドレ ス を 返し ます 。 
sze は 要求 する メモ リ の 大 き さ ( パ ラグ ラフ 単位 )、 segp は 新た に 割り 当て 
られ る プロ ッ ク の セグ メン ト が 格納 され る ワー ド を 指す ポイ ンタ で す 。 要 
求 量 に みあ う メ モリ が 残っ て いな い 場 合 に は , segp が 指す ワー ド に は アド 
レス は 代入 され ませ ん 。 
割り 当て られ た ブロック は , すべ て パラ グラ ブフ 境 界 に 配置 され ます 。 


戻り 値 allocmem は , メモ リプ ロッ ク の 確保 が 成功 し た 場合 に は -1 を 返し ます 。 
allocmem で エラ ー が あっ た 場合 に は 、 goseryor と eryzo に ENOMEM 
を セッ ト し ます 。 

可 搬性 allocmem は MS-DOS 特有 の も の で す 。 

関連 項目 coreleft. freemem、malloc、setblock 
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asctime 
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可 搬性 


関連 項目 
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日 付 と 時 刻 を ASCII 文字 列 に 変換 し ます 。 


#include <time.h〉 
char * asctime(const struct tm * め /oc) : 


time.h 


asctime は ,* / め /oc ん 中 の 構造 体 と し て 与え られ る 時 刻 を , ctime の 場合 と 
同じ 形式 の 26 文 字 の 文字 列 に 変換 し ます 。 


Sun Sep 16 01:03:52 1973*ng0 
asctime は , 日 付 と 時 刻 を 持つ 文字 列 を 指す ポイ ンタ を 返し ます 。 こ の 文字 
列 は 静 的 デー タ で , asctime の 呼び 出し が 行なわ れる ご と に 上 書き され ま 


す 。 


asctime は , すべ て の 関数 は UNIX シス テム で 使用 で き , ANSIC と 互換 
性 が あり ます 。 


ctime, difftime, ftime, gmtime, localtime, stime, time, tzset 
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例 nc1ude <stdlo.hz 
太 nc1ude <time.h> 


matn() 
struct tm *tm nowi 
time t secs_nowi 
char *str_nowi 


time(gsecs_now)i /* 時 刻 を 得る ( 秒 単位 ) */ 
str_now = ctime(&secs_now): /* 文字 列 に 変換 する  +*/ 


PrintE("The number of seconds since Jan 1,1970 1s z1dwnr, 
secs_now)i 
PrintE("Tn other words, the current time 1s Zs\n'。 str_now): 


tm_now = 1ocaltime(&secs_now): /* 構造 体 に 変換 する */ 
Printf("From the structurei day 7d 02d-Z02d-Z02d * 
"202d:Z02d:Z02d\Wn" 。 
tm_now->tm_yday, tm now->tm mon, 
tm_now->tm mday, tm now->tm year。 
tm_now->tm hour。 tm _now->tm min, tm now->tm sec): 


str_now = asctime(tm_now): /* 構造 体 か ら 文字 列 へ */ 
printf(*Once more, the current time 1e Zen"。 tr_now)i 
} 
プロ グラ ム 出 力 


The number of seconds since Jan 1,1970 is 315594553 

Tn other words, the current time is Tue Jan 01 12:09i13 1980 
From the structure: day 0 00-01-80 12:09:13 

Once more, the current time is Tue Jan 01 12:09:13 1980 
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aSin 


機能 逆 正 弦 を 求め ます 。 


形式 #include <math.h> 


double asin (double *) : 


プロ ト タ イ プ mathh 


解脱 asin は , 入力 値 の 逆 正弦 (アー クサ イン ) を 返し ます 。 引 数 * は, -1 か ら 
1 の 間 に な けれ ば な り ま せん 。 この 範囲 外 の 値 を 引数 と し て 与え る と , asin 
は 0 を 返し , errzo に EDOM (定義 域 エ ラー) を セ モット し ます 。 


戻り 値 asin は 、- ァ /2 一 ヶ /2 の 値 を 返し ます 。 
この 関数 に 対す る エラ ー 処 理 は , 関数 matherr を 使っ て 変更 する こと が で 
きま す 。 

可 搬性 asin は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 

関連 項目 acos,、 atan、 atan2. cos、cosh、 matherr, sin、 sinh, tan, tanh 
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aSSsert 


機能 


形式 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬性 


関連 項目 


条件 に よっ て プロ グラ ム を 異常 終了 させ ます 。 


#include <assert.h> 
#include <stdio.h> 
Void assert(int 7es7) : 


assert.h 


assert は , if 文 に 展開 され る マク ロ で す 。 引 数 /esr が 0 ( 偽 ) の 場合 に は , 
assert は メッ セー ジ を sdey に 出力 し (abort を 呼び 出し て ) プロ グラ ム 
を 異常 終了 させ ます 。 

assert は , 次 の よう な メッ セー ジ を 出力 し ます 。 


Assertion Failed: <test>。 11e <f11ename>, 11ne <11nenun> 


この 中 で , <test> は 引数 に 指定 し た 条件 式 , ezgyze と /qenz/z は , assert 

マク ロ が 存在 する ソー ス フ ァ イル 名 と 行 番号 で す 。 

ソー スコ ー ド の 中 で , #include <assert.h> よ り 前 に , #define NDEBUG 
("デバッグ 中 で は な い ") と いう 指令 を 置い て お く と , assert マク ロ は コ 
メン ト と し て 扱わ れ , その 部 分 は コン パイ ル さ れ ま せん 。 


戻り 値 は あり ませ ん 。 


assert は 、 シ ステ ム III お よび V を 含む 何 種類 か の UNIX シス テム で 使用 
で き , ANSI C と 互換 性 が あり ます 。 


abort 
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/* ASSERTST.C: リス ト に 追加 する 項目 が NOLL か どう か 調べ る */ 


すま include <asgert.h> 
#1nclude <stdio.h> 
ず #include <std11b.h> 


struct TTEN4 ( 
int keyi 
int Valuei 
} 


Yoid additem(struct TTEA4 *1temptr) 
6 

assert(itemptr != NULL): 

/* リス ト に 項目 を 追加 する ...*/ 
} 


maln() 


い 
additem(NULL) 


} 


プロ グラ ム 出 力 


Assertton falled: 1temptr 1= NULL, f11e C:\TURBOCWASSERT.C。 11ine 13 
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atan 


機能 逆 正 接 を 求め ます 。 


形式 #include <math.h> 
double atan(double *) ・ 


プロ ト タ イ プ mathh 


解説 atan は , 入力 値 の 逆 正 接 (アー クタ ンジ ェ ン ト ) を 返し ます 。 

戻り 値 atan は , -z/2 一 ヶ /2 の 値 を 返し ます 。 
この 関数 に 対す る エラ ー 処 理 は , 関数 matherr を 使っ て 変更 する こと が で 
きま す 。 

可 搬性 atan は UNIX シス テム て 使用 で き 、ANSI C と 互換 性 が あり ます 。 

関連 項目 acoS, aSim、 atan2, cos、 cosh、 matherr、 sin、 sinh、tan、tanh 
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了 /x の 逆 正 接 を 求め ます 。 


#include <math.h> 
double atan2 (double y, double *) : 


math.h 

atan2 は 、/* の 逆 正 接 を 返し ます 。 得 られ る 角度 が ァ /2 あ る い は -z/2 に 
近い (つま り x* が 0 に 近い ) 場合 で も 正しい 結果 が 得 ら れる は ず で す 。 

* と が と も に 0 で あっ た 場合 , atan2 は errzo に EDOM を セ モット し ま 
k 

atan2 は 、 - ァ ーー ァ の 値 を 返し ます 。 

この 関数 に 対す る エラ ー 処 理 は , 関数 matherr を 使っ て 変更 する こと が で 
きま す 。 


atan2 は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 


acoS, aSin。 atan、 coOS、 cosh、 matherr、sin。 sinh、tan、 tanh 
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atexit 
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可 搬 性 
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終了 時 関数 を 登録 し ます 。 


#include <stdlib.h> 


int atexit(atexit t 7zc) ・ 
stdlib.h 


atexit は 、/zc が 指し て いる 関数 を “終了 時 関数 "と し て 登録 し ます 。 プロ 
グラ ム が 正常 終了 する 際 に , exit は オペ レー ティ ング シス テム へ 制御 を 戻 
す 前 に , (* 7zc) () を 呼び 出し ます 。 呼び 出さ れる 関数 は Zrexr 7 型 で 
す 。 こ の 型 は , stdlib.h の 中 で typedef 宣言 され て いま す 。 

atexit が 呼び 出さ れる た びに 、 別 の 関数 が 登録 され ます 。 最 大 32 個 まで 登 
録 す る こと が で き , 最後 に 登録 きれ た も の か ら 順 に 実行 され ます 。 


atexit は 登録 に 成功 し た 場合 に は 0 を 返し 、 エ ラー の 場合 (関数 を 登録 する 
領域 が 足り な いと き な ど ) に は 0 で な い 値 を 返し ます 。 


atexit は ANSI C と 互換 性 が あり ます 。 


abort、 exit、 exit、 spawn.… 


Turbo C 標 準 関 数 リフ ァ レ ンス 59 


60 


ま #1nc1ude <std11b.h> 
ま 1nclude <stdio.h> 


atexit t exit fn1(void) 
{ 

Printf("Ex1t Function 1 cal11ed\n* ): 
} 


atexit t exit fn2(void) 
{ 

Printf("Exit Function 2 cal1led\n*) 
} 


maln() 

{ 
atexit(exit fn1): /* exit fn1 を 登録 */ 
atexit(exit fn2): /* exit_fn2 を 登録 */ 
Printf("Main quitting ...Wn'): 

} 


プロ グラ ム 出 力 


Main qultting ・・ 
Exit Function 2 called 
Exit Function 1 ca11ed 
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atof 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


文字 列 を 浮動 小数 点数 に 変換 し ます 。 


#include <math.h> 
double atof(const char * $) ・ 


math.h, stdlib.h 


atof は 、s が 指し て いる 文字 列 を double 型 に 変換 し ます 。 この 関数 は , 浮 
動 小数 点数 を 表現 する 文字 と し て 以下 の も の を 認識 し ます 。 


田 文 字 列 の 前 後に ある タプ と 空白 

較 待 号 

玉 数 字 の 並び と 小数 点 (数 字 は 小数 点 前 後に あっ て も よい ) 
玉 指 数 部 を 示す e また は E と, それ に 続く 符号 つき 整数 


変換 され る 文字 列 は , 次 の 一 般 形 式 に 沿っ て いな けれ ば な り ま せん 。 


【ws](sn][ddd][.][ddd][fmt[sn]ddd] 


ここ で , ws は ホワ イト スペ ー ス (空白 お よび タブ ), sz は 符号 、 7 は 数 
字 の 並び , 7 は e ま た は E を 示し て いま す 。 

atof は さら に , 填 INF お よび -INF を 正 お よび 負 の 無限 大 と し て , 十 NAN 
お よび -NAN を 非 数 (not a number) と し て 認識 し ます 。 

atof は , 認識 で き な い 文字 が 現われ た 段階 で 変換 を や め ま す 。 


atof は , 入力 文字 列 を 変換 し た 結果 の 値 を 返し ます 。 文 字 列 が double 型 の 
数 値 に 変換 で き な い 場合 に は 0 を 返し ます 。 

オー バー フロ ー が 起き た 場合 に は 、 atof は 正 ま た は 負 の HUGE VAL を 
返し ます (matherr は 呼ば れ ま せん )。 


atof は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あ り ます 。 
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関連 項目 
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atoi, atol, ecvt、fcvt、 gcvt,、 strtod 
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atoi 


機能 
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戻り 値 


可 搬性 
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文字 列 を 整数 に 変換 し ます 。 


int atoi(const char *※ ゞ ) : 


stdlib.h 


atoi は , ゞ が 指し て いる 文字 列 を int 型 に 変換 し ます 。 この 関数 は , 整数 値 
を 表現 する 文字 と し て 以下 の も の を 認識 し ます 。 


田 数 字 の 前 後に ある タプ と 空白 

較 符 号 

田 数 字 の 並び 
変換 され る 文字 列 は , 次 の 一 般 形式 に 沿っ て いな けれ ば な り ま せん 。 
ws][sn](ddd] 
ここ で , ws は ホワ イト スペ ー ス (空白 お よび タブ )、 sn は 符号 , ddd は 数 
字 の 並び を 示し て いま す 。 
atoi は 、 認 誠 で き な い 文字 が 現われ た 段階 で 変換 を や め ま す 。 


数 値 の オー バー フロ ー に つい て は 考慮 され ませ ん 。 


atoi は , 入力 文字 列 を 変換 し た 結果 の 値 を 返し ます 。 文 字 列 が int 型 の 数 値 
に 変換 で き な い 場合 に は 0 を 返し ます 。 


atoi は UNIX シス テム て で 使用 で き , ANSI C と 互換 性 が あり ます 。 


atof, atol, ecvt、fcvt、 gcvt 
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文字 列 を 倍 長 整数 (1omng) に 変換 し ます 。 


1ong atol(const char * 5) : 


stdlib.h 


atol は 、s が 指し て いる 文字 列 を long 型 に 変換 し ます 。atol は 、 和 整数 値 を 
表現 する 文字 と し て 以下 の も の を 認識 し ます 。 


田 数 字 の 前 後に ある タブ と 空白 
玉 待 号 
玉 数 字 の 並び 
変換 され る 文字 列 は , 次 の 一 般 形式 に 治っ て いな けれ ば な り ませ ん 。 
【ws ]( sn](ddd] 
ここ で , Ws は ホワ イト スペ ー ス (空白 お よび タブ ), sn は 符号 、 ddd は 数 
字 の 並び を 示し て いま す 。 
atol は 、 認識 で き な い 文字 が 現われ た 段階 で 変換 を や め ま す 。 


数 値 の オー バー フロ ー に つい て は 考慮 され ませ ん 。 


atol は 、 入力 文字 列 を 変換 し た 結果 の 値 を 返し ます 。 文字 列 が long 型 の 数 
値 に 変換 で き な い 場合 に は 0 を 返し ます 。 


atol は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 


atof, atoi、 ecvt、 fcvt, gcvt, strtol, strtoul 
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beep (PC-9801 の み ) 


機能 ビー プ 音 を 発生 させ ます 。 


形式 void beep (unsigned int ze) : 


プロ ト タ イ プ dosh 


機能 説明 beep は , sound に よっ て 設定 され て いる 周期 の ビー プ 音 を , yie に 指定 し 


た 繰り 返し 回 数 だ け 発生 きせ ます 。 


戻り 値 戻り 値 は あり ませ ん 。 


可 搬性 この 関数 は PC-9801 シ リー ズ で の みろ 動作 し ます 。 


関連 項目 sound 


例 sound(PC-9801) を 参照 し て くだ さい 。 
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bdos 

機能 DOS シス テム コー ル を 実行 し ます 。 

形式 int bdos(int dos7zz, unsigned dosgx, unsigned gos/) : 

プロ ト タ イ プ dosjh 

解説 bdos を 使っ て 、DOS シス テム コー ル の 多く に 直接 アク セス する こと が で 
きま す 。 各 シス テム コー ル の 詳細 に つい て は , MS.DOS プロ グラ マー ズリ 
ファ レン スマ ニュ アル を 参照 し て くだ さい 。 
引数 に 整数 を 必要 と する シス テム コー ル の 場合 は bdos を 使用 し ます 。 
ラー ジ デ ー タ モデ ル (コン バ パクト , ラー ジ , ヒュ ー ジ ) で は 。 引数 と し て 
ポイ ンタ を 必要 と する シス テム コー ル に つい て は , bdos で は な 〈 bdosptr 
を 使う 必要 が ある の て 注意 し て くだ さい 。 
引数 oz は 、 MS-DOS プロ グラ マー ズリ ファ レン スマ ニュ アル で 定義 
され て いる ファ ンク ショ ン 番 号 で す 。 
引数 ps の x は , DX レジ スタ の 値 で す 。 
引数 osg7 は 、 AL レジ スタ の 値 で す 。 

戻り 値 bdos の 戻り 値 は 。 シス テム コー ル に よっ て AX レジ スタ に セッ ト さ れ た 値 
で す 。 

可 搬性 bdos は MS-DOS に 特有 の 関数 で す 。 

関連 項目 bdosptr、 geninterrupt、 int86, int86x, intdos、 intdosx 
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例 お nclude <stdio.h> 
お nclude <dos.h> 
/* カレ ント ドラ イブ ("A'。 "B"。…・) を 得る */ 


char current_drtve(void) 


{ 


char curdrivei 


curdrive = bdos(0x19.0,0): 
return ( "A' + curdrive ): 


/* カレ ント ドラ イブ (0.1………) 


) 


main() 
{ 

Printf("The current drive is Zc:\n"。 current_drive()): 
} 


プロ グラ ム 出 力 


The current drive ie As 
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DOS シス テム コー ル を 実行 し ます 。 


int bdosptr(int do void * grgzzzez7。unSigned gosg/) : 


dos.h 


bdosptr を 使っ て , DOS シス テム コー ル の 多く に 直接 アク セス する こと が 
で きま す 。 各 シス テム コー ル の 詳細 に つい て は , MS.DOS プロ グラ マー ズ 
リフ ァ レ ンス マニ ュ ア ル を 参照 し て くだ さい 。 

ポイ ンタ 引数 を 必要 と する シス テム コー ル に つい て は bdosptr を 使用 し 
ます 。 

ラー ジ デ ー タ モデ ル (コン パク ト 。 ラー ジ 。 ヒュ ー ジ ) で は , 引数 と し て 
ポイ ンタ を 必要 と する シス テム コー ル に 対し て は , (bdos で は な く ) 
bdosptr を 使わ な けれ ば な り ま せん 。 

引数 oz は , MS-DOS プロ グラ マー ズリ ファ レン スマ ニュ アル で 定義 
され て いる ファ ンク ショ ン 番 号 で す 。 

引数 gw7iez7 は 。 スモ ー ル デー タモ デル で は シス テム コー ル に よっ て 使 
用 され る DX の 値 、 ラー ジ デ ー タ モデ ル で は DS : DX の 値 を 与え ます 。 

引数 osg7 は , AL レジ スタ の 値 で す 。 


bdosptr は 、 シス テム コー ル が 正しく 実行 され た 場合 に は AX の 値 を 返し , 
エラ ー が あっ た 場合 は eryzo と gdoseryzzo が セッ ト さ れ ま す 。 


bdosptr は MS-DOS に 特有 の 関数 で す 。 


bdos, geninterrupt, int86, int86x, intdos, intdosx 


harderr を 参照 し て くだ さい 。 
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brk 

機能 デー タ セ グ メ ント の スペ ー ス 割り 当て を 変更 し ます 。 

形式 int brk(void * gg の) : 

プロ ト タ イ プ alloch 

解説 brk は , 呼び 出し た プロ グラ ム の デー タ セ グ メ ント に 割り 当て られ て いる 
メモ リ 領 域 の 大 ほ き さ を , 動 的 に 変更 する 際 に 使用 し ます 。 変 更 は , プログ 
ラム の "プレ ー ク 値 "を 再 設 定 する こと に よっ て 行ない ます 。 プ レー ク 値 と 
は , デー タ セ グ メ ント の 最後 の すぐ 後ろ の の アド レス で す 。 割 り 当 て られ る 
領域 は 。 プレ ー ク 値 の 増加 に し た が っ て 増加 し ます 。 
brk は , プレ ー ク 値 に gd を セッ ト し, これ に 従っ て 割り 当て スペ ー ス を 
変更 し ます 。 
シス テム で 許さ れる 大 き さ を 越え る スペ ー ス を 確保 し よう と し た 場合 に は 
エラ ー と な り , 割り 当て スペ ー ス の 変更 は 行なわ れ ま せん 。 

戻り 値 割り 当て スペ ー ス の 変更 に 成功 し た 場合 、 brk は 0 を 返し ます 。 
変更 で き な か っ た 場合 に は -1 を 返し , errzo を 次 の 値 に セッ ト し ます 。 

ENOMEM メモ リ が 不足 し た 
可 搬性 brk は UNIX で 使用 で きま す 。 
関連 項目 coreleft、 sbrk 
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機能 


形式 


プロ ト タ イ プ 
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配列 内 の バイ ナリ サー チ (二分 探索 ) を 行ない ます 。 


#include <stdlib.h> 
void * bsearch(const void * ey, const void * の gse, 
size_t ze/eyr。 Size t wig7 が 


int (* cp) (conSt Void ※、const void *)) : 


stdlib.h 


bsearch は 、 メモ リ 上 の ze/eyz 個 の 要素 を 持つ テー ブル (配列 ) 内 を 検索 
し , 検索 キー に 一 致し た 最初 の 項目 の アド レス を 返し ます 。 一 致す る 項目 
が な か っ た 場合 は 0 を 返し ます 。 

sze 7 は , unsigned int と し て 定義 きれ て いま す 。 

テー プル の 中 の 項目 は bsearch を 呼び 出す 前 に 昇順 に ソー ト され て いな 
けれ ば な り ま せん 。 


較 zeey: に は ,、 テー ブル 中 の 要素 の 個数 を 与え ます 。 
一 2 に は 、 テー ブル 中 の 1 つの 要素 の バイ ト 数 を 指定 し ます 。 


yp は , ユー ザ が 定義 する 比較 ルー チン を 指す ポイ ンタ で す 。 比較 ルー チ 
ン は , eezz7 と eezz2 の 2 つの 引数 を と り ま す 。2 つ の 引数 は それ ぞ れ 比較 さ 
れる 値 を 指し ます 。 比較 関数 は , 2 つの 引数 が 指す 項目 (* eez/, * eeyz2) 
を 比較 し , その 結果 に し た が っ て 整数 値 返 し ます 。 

* た zp の 戻り 値 は 次 の よう に な り ま す 。 


較 * eez7 < * eez2 の 場合 、0 よ り 小 さい 値 
一 * eezz/ ニー ※* eezz2 の 場合 、0 


一 * eez:7 > * efe7z2 の 場合 、 0 より 大 きい 値 


通常 は , eezz7 は 引数 ey で , eezz2 は 検索 の 対象 と な る テー プル 内 の 項目 
を 指し ます 。 
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zz が 検索 キー や テー プル の 項目 を どの よう に 解釈 する か は 自由 で あり , 
ユー ザ が 必要 と する 方 法 で 定義 むる こと が で きま す 。 

bsearch は , テー ブル 中 を 検索 する た め に , 7 を czp が 指す アド レス に ある ル 
ー チ ン (比較 関数 ) を 繰り 返し 呼び 出す こと に な り ま す 。 


戻り 値 bsearch は , テー ブル 内 で 検索 キー と 一 致し た 最初 の 項目 の アド レス を 返 
し ます 。 一 致す る 項目 が な か っ た 場合 に は 0 を 返し ます 。 


可 搬性 bsearch は UNIX シス テム で 使用 で き 、 ANSI C と 互換 性 が あり ます 。 
関連 項目 lfind、lsearch, qsort 


例 #include <stdio.h> 
#include <std1ib.h> 


#define NELEMS(arr) (sizeof(arr) / sizeoE(arr[0])) 
nt numarray[] = ({ 123、145。 512。 627。 800, 933 ): 


int numeric(int *p1。 int *p2) 
{ 

return(*p1 - *P2)i 
) 


/* テー ブル 内 の キー で あれ ば 1, そう で な けれ ば 0 を 返す */ 
int 1ookup(int key) 
( 

1nt *1temptri 


/* bsearch( ) は ,。 見 つか っ た 項目 へ の ポイ ンタ を 返す */ 
1temptr = (int *) bsearch(&key, numarray, NELEMS(numarray), 
sizeof(1nt) , nomeric)i 
return (1temptr 1= NOLL): 
} 


main() 
( 
printE("Ts 512 in tab1e? *): 


printE("Zsn* 。 1ookup(512) ? "YES" : *NO")j 
} 


プロ グラ ム 出 力 


Ts 512 in table? YES 
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複素 数 の 絶対 値 を 返し ます 。 


#include <math.h> 
double cabs (struct complex z) : 


math.h 


cabs は 、 複素 数 z の 絶対 値 を 計算 する マク ロ で す 。 z は complex 型 の 構造 
体 で す 。 こ の 構造 体 は math.h の 中 で 次 の よう に 定義 され て いま す 。 
struct complex { 

double x。 yi 
PH 


* が 実数 部 , が 虚数 部 で す 。 
cabs の 呼び 出し は , z の 実数 部 と 虚数 部 を 大 の よう に し て sqrt を 呼び 出す 
こと と 同じ に な り ま す 。 


sqrt(z. エ ネタ. メオ イタ. アマネ . ツ ) 


cabs を , マク ロ で は な く 関 数 と し て 扱い た い 場合 は , プロ グラ ム に 次 の 1 行 
を 書い て くだ さい 。 


#undef cabs 


cabs は , z の 絶対 値 を double 型 で 返し ます 。 オー バー フロ ー が あっ た 場合 
は HUGE_VAL を 返し 、 errzo に ERANGE (結果 が 指定 の 範囲 を 越え た ) 
を セッ ト し ます 。 

cabs の エラ ー 処 理 は , matherr 関数 を 使っ て 変更 する こと が で きま す 。 
cabs は UNIX シス テム て 使用 で きま す 。 


abs, fabs, labs、 matherr 
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calloc 


機能 


形式 
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メイ ン メ モリ を 割り 当て ます 。 


#include <stdlib.h> 
void * calloc(size t ZZ7e/xs, Size t se) : 


stdlib.h, alloch 


calloc は 、C の メモ リヒ ー プ へ の アク セス を 提供 し ます 。 ヒー プ は 、 可変 サ 
イズ の メモ リプ ロッ ク の 動 的 割 ) 当て に 使用 する こと が で きま す 。 木 構造 
や 線形 リス ト な ど 多 く の デ ー タ 構造 は 、 通 常 こ の ヒー プ 領 域 に 置か れ ま す 。 
スモ ー ル デー タモ デル (タイ ニ ィ , スモ ー ル ,。 ミディ アム ) で は , デー タ 
セグ メン ト の 終わ りか ら プ ログ ラム スタ ッ ク の 先頭 まで を ヒー プ と し て 使 
用 する こと が で きま す 。 た だ し 、 ス タッ ク グ の 先頭 の 直前 256 バ イト は , アプ 
リケーション 用 の スタ ッ ク の 拡張 領域 と MS-DOS が 使用 する 領域 と し て 
確保 され て いる た め 除 外さ れ ま す 。 

ラー ジ デ ー タ モデ ル (コシ パク ト 。 タージ). ヒュ ー シ ジ ) で は ログ ラム 
スタ ッ ク を 越え て , メモ リ の 物理 的 な 最終 位置 まで ヒー プ と し て 使用 可能 
で す ? 

calloc は , サイ ズ zzezs Xsze の プ ブロック を 確保 し ます 。 ブ ロッ ク 中 の 各 バ 
イト は ゼロ クリ ア さ れ ま す 。 


calloc は , 新た に 確保 され た プロ ッ ク を 指す ポイ ンタ を 返し ます 。 メ モリ 
が 不足 し て プ ブロッ ク を 確保 で き な か っ た 場合 、 あ る い は zirezy また は sze 
が 0 だ っ た 場合 に は NULL を 返し ます 。 


calloc は UNIX シス テム て 使用 で き , ANSIC と 互換 性 が あり ます 。K& 
R で も 定義 8 され て いま す 。 


farcalloc, free、 malloc, realloc 


Turbo C 標 準 関数 リフ ァ レ ンス 73 


機能 小数 点 以下 の 切上げ を 行ない ます 。 


形式 #include <math.h> 
double ceil(double *) : 


プロ ト タ イ プ math.h 


解説 ceil は , * を 下 ま わら な い 最 小 の 整数 を 返し ます 。 

戻り 値 ceil は , 上 で 述べ た 整数 を double で 返し ます 。 

可 搬性 ceil は UNIX シス テム て で 使用 で き , ANSI C と 互換 性 が あり ます 。 
関連 項目 farcalloc,、 free、 malloc, realloc 
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cgets 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬 性 


関連 項目 


コン ソー ル か ら 文 字 列 を 読み 込み ます 。 


char * cgets(char * 5 な ) : 


conio.h 


cgets は 、 コ ン ソ ー ル か ら 文字 の 列 を 読み 込み 、 その 文字 列 ( お よび その 長 
さ ) を s7 が 指す 場所 に 格納 し ます 。 

cgets は 、CR/LF に 出会う まで , また は 最大 文字 数 まで 文字 を 読み 込み ま 
す 。CR/LF を 読む と 、cgets は CR/LF を \0( ヌ ル 文 字 ) に 置き 換え て か 
ら 格 納 し ます 。 

cgets を 呼び 出す 前 に 、 sy[0] に は 読み 込む 文字 列 の 最大 長 を 入れ て お く 必 
要 が あり ます 。 cgets の 実行 が 終わ る と 、s[1] に 実際 に 読み 込ま れ た 文 
数 が セッ ト さ れ て いま す 。 読 み 込ま れ た 文字 は sr[2] か ら 始ま り , ヌ ル 文 字 
で 終わ り ま す 。 し た が っ て s の 長 さ は , 最低 sy ケ [0]+2 バ イト ある 必要 が 
あり ます 。 


成功 し た 場合 cgets は sy[2]、 つ まり 読み 込ま れ た 文字 列 の 先頭 を 指す 
ポイ ンタ を 返し ます 。 エ ラー 戻り は あり ませ ん 。 


cgets は PC-9801 シ リー ズ (また は グラ フィ ックス ディ スプ レイ アダ プ タ 
を 備え た IBM PC お よび その 互換 機 ) で の み 動 作 し ます 。 


fgets, getch, getche、 gets 
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#1nclude <stdio.h> 
ま include <conio.h> 


main() 

{ 
char buffer[82]: 
char *pi 


buffer[0] - 80: /* 80 文 字 分 の スペ ー ス */ 

p - cgets(buffer) : 

Printf("\ncgete got 7d characterei "Zsw'gnr。 buffer[1], p): 

Printf("The returned pointer 1e Zp。 buffer[2] 1S at ZDWn'。 
p, &buffer): 


buffer[0] = 5: /* スペ ー ス を 5 文字 分 だ け に する */ 
p = cgete(buffer) : 


Prlntf("\ncgets got Zd charactere: "Xe な "fn" 。 buffer[1], p)i 


printf("The returned pointer is Xp。 buffer[2] 19 at ZpWnP。 
p, sbuffer): 


プロ グラ ム 出 力 


abcdefghijE1m 
cgets got 12 charg: "abcdefghi]k1my 


The returned polnter 1s EEE6,。 buffer[2] 1s at FEPF6 
abcd 


cgets got 4 characters: "abcd" 
The returned pointer 15 FEP6。 buEfer[2] 1e at PEF6 
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chdir 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


カレ ント ディ レク トリ を 変更 し ます 。 

int chdir (const char * pg 誰 ) : 

dir.h 

chdir は , pg で 指定 し た ディ レク トリ を , 現在 の 作業 ディ レク トリ に し 
ます 。pg 放 は 実際 に 存在 する ディ レク トリ で な けれ ば な り ま せん 。 

pg が の 中 に は 。 次 の よう に ドラ イブ 名 を 含め る こと も で きま す 。 


chdir("a:WWturboc" ) : 


た だ し この 場合 、 指 定 ド ライ プ の カレ ント ディ レク トリ が 変更 きれ る だ け 
で , カレ ント ドラ イブ は 変更 きれ ませ ん 。 


変更 に 成功 すれ ば 0 を 返し ます 。 そう で な けれ ば -1 を 返し 、errzo を 次 の よ 
うに セッ ト し ます 。 


ENOENT バス 名 また は ファ イル 名 が 見 つか ら な い 


chdir は UNIX シス テム で 使用 で きま す 。 


getcurdir、getcwd、mkdir、rmdir、 system 
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_chmod 


機能 


形式 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬性 


関連 項目 
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ファ イル の アク セス モー ド を 変更 し ます 。 


#include <dos.h> 
#include <io.h> 


int chmod(const char * pg が int ze [int 7 の め ]) : 


io.h 


_chmod は , DOS の ファ イル 属性 の 読み 出し また は 設定 を 行ない ます 。 
7&zc が 0 の 場合 chmod は pg が に 指 定 し た ファ イル の 現在 の DOS 属性 
を 返し ます 。/zc が 1 の 場合 に は 、 属性 を 47 み め で 指定 し た 値 に 設定 し ま 
す 。 

gi の め は 、 以下 に 示す シン ポリ ッ ク 定 数 (io.h の 中 で 定義 きれ て いま す ) の 
いずれ か で す 。 


FA_RDONLY 読み 出し 専用 

FA HIDDEN 隠し ファ イル 

FA SYSTEM シス テム ファ イル 
_chmod は , 成功 し た 場合 は ファ イル 属性 ワー ド を 返し , そう で な けれ ば 
-1 を 返し ます 。 


エラ ー の 場合 、 er7zo に 以下 の 値 の いずれ か が セッ ト さ れ ま す 。 


ENOENT パス 名 また は ファ イル 名 が 見 つか ら な い 
EACCES アク セス は 許可 され て いな い 


_chmod は MS-DOS に 特有 な も の で す 。 


chmod, creat 
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chmod 


機能 ファ イル の アク セス モー ド を 変更 し ます 。 


形式 #include <sys\stat.h> 
int chmod (const char * pg int goge) : 


プロ ト タ イ プ ioh 


解説 chmod は 、 pg 放 に よっ て 与え られ る ファ イル の アク セス 許可 を , gzode で 
指定 され た マス ク に セッ ト し ます 。 pg は , ファ イル 名 を 含む 文字 列 を 指 
し ます 。 


gzode は 、S_IWRITE, S IREAD (sys\stat.h の 中 で 定義 され て いま す ) 
の いずれ か , また は 両方 を 持つ こと が で きま す 。 


7 の de の 値 アク セス 許可 
S IWRITE 書き 込み 可 
S_IREAD 読み 出し 可 


S_IREAD | SIWRITE 読み 出し / 書 き 込み 可 


戻り 値 chmod は ,、 フ ァイル アク セス モー ド の 変更 に 成功 し た 場合 は 0 を 返し そう 
で な けれ ば -1 を 返し ます 。 
エラ ー の 場合 erzzo に 以下 の 値 の いずれ か が セッ ト さ れ ま す 。 


ENOENT バス 名 また は ファ イル 名 が 見 つか ら な い 
EACCES アク セス は 許可 きれ て いな い 


可 搬性 chmod は UNIX シス テム て 使用 で きま す 。 


関連 項目 access、 chmod, fstat、 open,、 sopen、 stat 
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nc1ude <stdio.h> 
すま include <sysstat .h> 
1nc1ude <1o.h> 


Yoid make_read_on1y(char *E1ename ) 
( 
int stati 
Stat = chmod(fi1ename, S TREAD): 
1f (stat) 


Printf("cou1dn*t make Zs read-on1y\n*」 fi1ename ) 


else 


Printf(*"made Zs read-on1y\n* 。 Fi1ename ) : 


} 


main() 
い ( 
make_read_on1y("NOEXTST.PTL" ) : 
make_read_on1y("MYFTLE.FTL') : 
} 


プロ グラ ム 出 力 


cou1dn*t make NOEXTST.FTL read-on1y 
made MYFTLE.FTL read-on1y 


第 2 章 Turbo C ラ イブ ラリ 


chsize 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 


ファ イル サイ ズ を 変更 し ます 。 
int chsize(int Agzg/e, long sze) ・ 
io.h 


chsize は 、 4gzfe に 対応 する ファ イル の 大 き さ を 変更 し ます 。sze の 値 
と , ファ イル の 最初 の 大 き さ と の 関係 に よっ て , ファ イル の 一 部 を 切り 拾 
て る か , 大 きく する か が 決ま り ま す 。 

オー プン する ファ イル の モー ド は , 書き 込み 可能 で な けれ ば な り ま せん 。 
chsize が ファ イル を 大 きく する と き に は , ヌル 文字 (\0) を 追加 し ます 。 
ファ イル を 切り 捨て る 場合 は , 新しい ファ イル の 終わ り 以 降 の 文字 は 失わ 
れ ま す 。 


chsize は 成功 すれ ば 0 を 返し ます 。 失敗 し た 場合 は -1 を 返し , eryo に 次 の 
いずれ か を セッ ト し ます 。 


EACCESS アク セス が 拒否 され た 
EBADF ファ イル 番号 が 正しく な い 
ENOSPC UNIX で ある 一 DOS で は を ない 


chsize は MS-DOS に 特有 の 関数 で す 。 


close、 creat, creat, fopen 
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ーー ニー ニー ニー ニニ ーー ニー ニー ニニ ーー ニー ーー ニー ニー ニュ 一 
_clear87 


機能 浮動 小数 点 ス テー タス ワー ド を クリ ア し ます 。 

形式 unsigned int clear87(void) : 

プロ ト タ イ プ floath 

解説 _clear87 は 、 浮動 小数 点 ス テー タス ワー ド を クリ ア し ます 。 浮動 小数 点 ス 
テー タス ワー ド は , 8087/80287 ス テー タス ワー ド と , 8087/80287 例 外 ハ ン 
ドラ に よっ て 検出 され た 他 の 条件 か ら な る も の で す 。 

戻り 値 返さ れる 値 の ビッ トバ ター ン は , 浮動 小数 点 ス テー タス ワー ド を 示し て い 
ます 。 ス テー タス ワー ド の 詳細 に つい て は , float.h で 定義 され て いる 定数 
を 参照 し て くだ さい 。 


関連 項目 _control87、 fpreset、 status87 


例 _control87 を 参照 し て くだ さい 。 
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clearerr 


機能 エラ ー 状 態 を リセ モット する 


形式 #include <stdio.h> 


void clearerr (FILE * seg7 が ) ・ 


プロ ト タ イ プ stdio.h 


解説 clearerr は , seg に 指定 され た の エラ ー 標 識 と ファ イル 終了 標識 を 0 に 
し ます 。 
エラ ー 標 識 が セッ ト さ れる と 、 clearerr また は rewind の 呼び 出し が 行 な 
われ る まで , その スト リー ム に 対す る 操作 は 常に エラ ー を 返し ます 。 
ファ イル 終了 標識 は 入力 操作 に よっ て リセ ッ ト さ れ ま す 。 


戻り 値 戻り 値 は あり ませ ん 。 
可 搬性 clearerr は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 
関連 項目 eof, feof、 ferror、 perror, rewind 
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機能 プロ セッ サ 時 間 を 得 ます 。 


形式 #include <time.h> 
clock t clock(void) : 


プロ ト タ イ プ time.h 


説明 clock は 2 つの イベ ント の 間 の 時 間 を 測定 する の に 使う こと が で きま す 。 
その 時 間 を 秒 単位 で 表現 する に は , clock が 返し た 値 を マク ロ CK 7CK 
で 割る 必要 が あり ます 。 


戻り 値 clock は , プロ グラ ム の 開始 か ら 経過 し た プロ セッ サ 時 間 を 返し ます 。 プロ 
セッ サ 時 間 が 得 ち られ な い , ある い は その 値 が 表現 不可 能 の 場合 は 関数 は 
-1 を 返し ます 。 

可 搬性 clock は ANSI C と 互換 性 が あり ます 。 

例 1nclude <time.h> 


#Hnc1ude <etdio.h> 
Yod main() 
5 Clock _t start。 endi 
start = clock(): 
/* 時 間 を 測る コー ド が ここ に 入る +/ 


end = clock(): 
Printf("The time was: fwn'。 (end - Start) / CLK_TCK): 


84 第 2 章 Turbo C ラ イブ ラリ 


_close 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


ファ イル を クロ ー ズ し ます 。 
int close(int Agzge) : 
ioh 


_close は , gzd/e に 結び つけ られ て いる ファ イル を クロ ー ズ し ます 。 

ん gz の 7e は 、 creat、 creat, creatnew, creattemp, dup, dup2, 

_open。 open の 呼び 出し に よっ て 得 ち られ た ファ イル ハン ドル を 持っ て いま 
す 。 


注意 : close は 、 ファ イル の 最後 に CTRL-Z (0x1a) を 書き 込み ませ ん 。 
ファ イル の 最後 に CTRL-Z が 必要 で あれ ば , クロ ー ズ する 前 に な ん ら か の 
方 法 で 書き 込ん で お か な けれ ば な り ま せん 。 
クロ ー ズ に 成功 し た 場合 は 0 を 返し 。 そう で な けれ ば -1 を 返し ます 。 
gz が 有効 な オー プン ファ イル で な か っ た 場合 に は エラ ー と な り , 
eryO に 次 の 値 が セッ ト さ れ ま す 。 

EBADF ファ イル 番号 が 正しく な い 


_close は MS-DOS 特有 の も の で す 。 


close. creat, open、read, write 
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プ ブ プロトタイプ 


解説 
戻り 値 
| 


可 搬性 


関連 項目 
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ファ イル を クロ ー ズ し ます 。 
int close(int gzg/e) ・ 
io.h 
close は gz に 結び つけ られ て いる ファ イル ハン ドル を クロ ー ズ し ま 
す 。 ge は 、 cerat, creat、 creatnew、 creattemp, dup、 dup2, 
_open, open の 呼び 出し に よっ て 得 ら れ た ファ イル ハン ドル で す 。 
注意 close は,、 ファ イル の 最後 に CTRL-Z(0x1a) を 書き 込み ませ ん 。 フ 
ァイル の 最後 に CTRL-Z が 必要 で あれ ば , クロ ー ズ する 前 に な ん ら か の 方 
法 で 書き 込ん で お か な けれ ば な り ま せん 。 
クロ ー ズ に 成功 し た 場合 は 0 を 返し , そう で な けれ ば -1 を 返し ます 。 
4gzde が 有効 な オー プン ファ イル で な か っ た 場合 に は エラ ー と な り , 
eryzO に 次 の 値 が セッ ト さ れ ま す 。 

EBADF ファ イル 番号 が 正しく な い 


close は UNIX シス テム で 使用 で きま す 。 


chsize、 close、 creat、creatnew、dup, fclose, open, sopen 
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_control87 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


浮動 小数 点 制御 ワー ド を 操作 し ます 。 


unsigned int control87 (unsigned int ew, unsigned int 7 の ん) ・ 


floath 


_control87 は , 浮動 小数 点 制御 ワー ド の 取り だ し , また は 変更 に 使用 し ま 
す 。 

浮動 小数 点 制御 ワー ド は , unsigned int で 、 ビ ッ ト ご と に 浮動 小数 点 パ ッ 
ケー ジ の モー ド を 示す よう に な っ て いま す 。 モー ド に は , 精度 , 無限 値 や 
丸め の 取り 扱い な ど が あり ます 。 こ うし た モー ド を 変更 する こと に よっ て 。 
浮動 小数 点 の 例外 処理 を マス ク し た り , アン マス ク し た りす る こと が で き 
ます 。 

_control87 は 、 5 の 各 ビ ピット を zew の 各 ビ ッ ト に 対応 させ ます 。 gs ん 
の ビッ ト が 1 の 場合 zew の 対応 する ビッ ト が 浮動 小数 点 制御 ワー ド の 同 
し ビッ ト の 新しい 値 を 示す こと に な り , 制御 ワー ド に は この 新しい 値 が セ 
ッ ト き され ます 。 

以下 は , この 動作 の 例 で す 。 


元 の 制御 ワー ド : 0100 0011 0110 0011 


mask: 1000 0001 0100 1111 
newvale: 1110 1001 0000 0101 


変更 され る ビッ ト : 1xxx xxx1 xOxx 0101 


gs が 0 の 場合 control87 は 浮動 小数 点 制御 ワー ド を 変更 せ ず に 返し ま 
す 。 


返さ れる 値 の ビッ トバ パタ ー ン は , 浮動 小数 点 制 御 ワ ー ド の 新しい 値 を 表 わ 
し て いま す 。_control87 が 返す ビッ トバ ター ン の 詳細 な 定義 に つい て は , 
floath を 参照 し て くだ さい 。 
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関連 項目 


例 
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_clear87、 fpreset,。 signal, _status87 


#1nclude <math.h> 
ま 1nclude <F1oat .h> 
すま 1nclude <stdio.h> 


す dfine Cw NEW (Cw_DEFAULT | RA ZERODIVTDE | ER OVERFLOWw) 
#define MASK_ALL (OxFEFP) 


main() 
6 
float a, b。 ci 


_contro187(CW_NEWIEM_TNVALTD。MASK_ALL): 
a = 1.0: 

b・0. 
c = a/ 


1f(_statue87() & SW_ZERODTVTDE) 

{ 
fprintf(stderr。 "DTVTSTON BY 2ERO.\n*): 
_c1ear87(): 
return(1)i 


第 2 章 Turbo C ラ イブ ラリ 


coreleft 


機能 未 使用 メモ リ の 量 を 調べ て 返し ます 。 


形式 ・ タ イニ ィ 。 ス モー ル , ミディ アム モデ ル の 場合 


unsigned coreleft (void) : 


・ コ ン パ クト , ラー ジ 。 ヒュ ー ジ モデ ル の 場合 


unsigned long coreleft (void) : 


プロ ト タ イ プ alloch 


解説 coreleft は , 未 使用 の メモ リ 量 返し ます 。 返 され る 値 は メモ リモ デル が 
スモ ー ル デー タモ デル か 、 ラー ジ デ ー タ モデ ル か に よっ て 異な り ま す 。 


戻り 値 ラー ジ デ ー タ モデ ル で は , ヒー プ と スタ ッ ク の 間 の 未 使用 メモ リ の 量 を 返 
し ます 。 
スモ ー ル デー タモ デル で は スタ ッ ク と デー タ セ グ メ ント の 間 の 未 使用 メ 
モリ の 量 か ら 256 バ イト を 引い た 値 を 返し ます 。 

可 搬性 coreleft は MS-DOS に 特有 の 関数 で す 。 


関連 項目 allocmem, brk, farcoreleft、 malloc 
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COS 


機能 


形式 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬性 


関連 項目 


20 


余弦 を 求め ます 。 


#include <math.h> 


double cos(double *) : 


math.h 


cos は 、 入力 値 の 余弦 (サイ ン ) を 返し ます 。 角 度 バ は ラジ アン 単位 で 指定 
し ます 。 


cos は , -1 か ら 1 の 範囲 で 値 を 返し ます 。 
この 関数 に 対す る エラ ー 処 理 は , 関数 matherr を 使っ て 変更 する こと が で 
きま す 。 


cos は UNIX シス テム で 使用 てき, ANSI C と 互換 性 が あり ます 。 


acos、 aSim、 atan, atan2, cosh、matherr、 sin、 sinh、tan, tanh 
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機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項 


双曲線 余弦 を 求め ます 。 


#include <math.h> 
double cosh(double *) ・ 


math.h 


cosh は 実数 引数 に 対す る 双曲線 余弦 (ハイ バ ポ リッ クサ イン ) を 計算 し 
ます 。 


引数 の 双曲線 余弦 を 返し ます 。 

計算 結果 が オー バー フロ ー し て し まう 場合 に は , cosh は 適切 な 符号 を つけ 
た HUGE_VAL を 返し , eryzo に ERANGE を セッ ト し ます 。 

この ルー チン の エラ ー 処 理 は , matherr 関数 を 通じ て 変更 する こと が で き 
ます 。 


cosh は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


acos, asin、 atan, atan2、 cos、matherr, sin。 simh、tan、tanh 
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“gc 
country 


機能 国 別 情報 を 返し ます 。 


形式 #include <dos.h> 


Struct country *※ country(int xcode, struct country * Cp) : 


プロ ト タ イ プ dosh 


解説 country は 、 国 別 情報 (日付, 時刻, 通貨 な を ど ) を どの よう な 書式 で 表現 
する か を 指定 し ます 。 こ の 関数 に よっ て セッ ト さ れる 値 は 使用 し て いる 
MS-DOS の バー ジョ ン に よっ て 異な り ま す 。 
の の 値 が -1 で ある と , 現在 の 国 は xcoge の 値 に セッ ト さ れ ま す 。xcoge は 
0 で あっ て は な り ま せん 。 ep が -1 以 外 の 場合 に は , cp が 指す 構造 体 coun- 
try が , 以下 の いずれ か の 情報 で 埋め られ ます 。 


田 現 在 の 国 (xco7e が 0 の 場合 ) 
田 xco7e で 指定 され た 国 


構造 体 country は 、 dos.h の 中 で 以下 の よう に 定義 され て いま す 。 


struct country ( 


1nt co_datesi /* 日 付 書式 
char co_curr[5]1 /* 通貨 記号 */ 
char co_thsep[2]: /* 3 桁 ご と の 区 切り 記号 */ 
char co_desep[2]i /* 10 進 数 分 離 記号 / 
char co_dtsep[2]: /* 日 付 分 離 記号 */ 
char co_tmsep[2]: /* 時 刻 分 離 記号 // 
char co_currsty1e: /* 通貨 の 形式 7/ 
char co_digitei /* 通貨 の 桁 数 */ 
char co_timei /* 時 刻 形 式 bi 
1ong co_c /* ケー スマ ッ プ 7 
char co_dasepi /* デー タ の 区 切り 記号 */ 
char co_E111[10]: /* フィ ラ ( 埋 め る 文字 ) */ 


ji 
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co_gg7e の 日 付 書式 は , 次 の よう に な り ま す 。 


0 米国 式 (月 - 日 - 年 ) 
1 欧州 式 (日 - 月 - 年 ) 
2 日 本 式 (年 - 月 - 日 ) 


co_cezs の Pe が 示す 通貨 表示 形式 は 、 以下 の よう に な り ま す 。 


0 通貨 記号 は 数 値 の 前 , 通貨 記号 と 数 値 の 間 に は 空白 な し 
1 通貨 記号 は 数 値 の 後ろ , 通貨 記号 と 数 値 の 間 に は 空白 な し 
2 通貨 記号 は 数 値 の 前 通貨 記号 と 数 値 の 間 に 空 白 1 個 

3 通貨 記号 は 数 値 の 後ろ , 通貨 記号 と 数 値 の 間 に 空 白 1 個 


戻り 値 成功 すれ ば , country は ポイ ンタ 引数 ゅ を 返し ます 。 エラ ー が あっ た 場合 
に は NULL を 返し ます 。 
可 搬性 country は MS-DOS 3.0 以 降 で 使用 で きま す 。 
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cprintf 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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画面 に 書式 つき 出力 を 行ない ます 。 


int cprintf (const char * /orzzg7 [, g/gaze77…]) : 


conio.h 


cprintf は , /orzg7 に よっ て 指 さ れ る 書式 文字 列 中 の 書式 指定 を , 7oyyg7 
の 後に 続く 各 引数 に 適用 し , 書式 化 さ れ た デー タ を 画面 上 の カレ ント テキ 
スト ウィ ンド ウ に 直接 出力 し ます 。 書 式 指定 は 、 後に 続く 引数 と 同じ 数 だ 
け な け れ ば な り ま せん 。 

書式 指定 に 関す る 詳細 な 情報 に つい て は , printf の 解説 を 参照 し て くだ さ 
い 。 

cprintf は 、printf お よび fprintf と は 異な り , 改行 文字 (\n) を 復帰 改 
行 ペ ア ( ぎ rn) に 変換 し ませ ん 。 


cprintf は 出力 し た 文字 数 を 返し ます 。 


cprintf は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 
時 


decfozgeo( 変 数 )、 fprintf, printf,、 putch、sprintf, vprintf 


printf を 参照 し て くだ さい 。 
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形式 


プロ ト タ イ プ ブ 


戻り 値 


可 搬 性 


関連 項目 


画面 に 文字 列 を 出力 し ます 。 


int cputs(const char な) ・ 


conio.h 


cputs は , ヌル で 終わ る 文字 列 sr を , カレ ント テキ スト ウイ ンド ウ に 書き 
ます 。 復 改 文字 は 付加 され ませ ん 。 

PC-9801 で は , 文字 列 は 直接 テキ スト VRAM に 書き 込ま れ ま す 。 IBM PC 
の 場合 に は 、 グロ ー バ ル 変 数 greefpdeo の 値 に よっ て , 画面 メモ リ に 直 
接 書 き 込ま れる か , BIOS を 通じ て 出力 され る か が 決ま り ま す 。 

cputs は 、puts と は 異な り 、 改 行文 字 (\n) を 復帰 改行 ペア ( ぎ r\n) に 
変換 し ませ ん 。 


cputs は 、 最 後に 書い た 文字 を 返し ます 。 


cputs は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 し 
ます 。 


gzrecfozdeo( 変 数 )、 putch。 puts 
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_creat 
機能 新しい ファ イル を 作成 する 、 ある い は 既存 の ファ イル を 書き な お し ます 。 
形式 #include <dos.h> 
int creat(const char * pg が , int の 7 の め ) : 
プロ ト タ イ プ ioh 
解説 _-creat は 、 新 し い フ ァイル を 作成 する か 、 あ る い は すでに 存在 する ファ イ 
ル を 書き な お す た め の 準備 を 行ない ます 。 作成 また は 書き な お され る ファ 
イル は , pg 太 に よっ て 与え られ ます 。 
_creat は , DOS の 属性 ワー ド g み め を 引数 に と り ま す 。 creat の 呼び 出し 
で は , どの 属性 ビッ ト も セッ ト す る こと が で きま す 。 フ ァイル は , 常に バ 
イナ リモ ー ド で オー プン され ます 。 フ ァイル の 作成 に 成功 すれ ば , ファ イ 
ルポ イン タ は ファ イル の 先頭 に セッ ト さ れ ま す 。 ファ イル は , 読み 込み / 書 
き 込 み 可 で オー プン され ます 。 
ファ イル が すでに 存在 し て いる 場合 、 その サイ ズ は 0 に リセ ッ ト さ れ ま す 
(これ は , その ファ イル を 削除 し て か ら 同 名 前 で 新た に 作成 する の と , 
基本 的 に は 同じ こと で す )。 
_creat に 渡す 引数 2 の め は , (dos.h で 定義 され て いる ) 以下 の いずれ か の 
値 を と る こと が で きま す 。 
FA_RDONLY 読み 出し 専用 属性 
FA HIDDEN 隠し ファ イル 
FA _ SYSTEM シス テム ファ イル 


96 
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戻り 値 動作 に 成功 し た 場合 、 creat は 新しい ファ イル ハン ドル ( 負 で な い 整 数 ) 
を 返し , エラ ー の 場合 に は -1 を 返し ます 。 
エラ ー が あっ た 場合 errzo に は 次 の 値 の いずれ か が セッ ト さ れ ま す 。 
ENOENT  。 パス 名 また は ファ イル 名 が 見 つか ら な い 
EMFILE オー プン ファ イル が 多 す ぎる 
EACCES アク セス は 許可 され て いな い 


可 搬性 _creat は MS-DOS に 特有 の 関数 で す 。 


関連 項目 _chmod, chsize,、 close, close、creat、 creatnew、 creattemp 
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creat 


機能 


形式 


プロ ト タ イ プ 


解説 
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新しい ファ イル を 作成 する , ある い は 既存 の ファ イル を 書き な お し ます 。 


#include <sys\stath> 
int creat(const char * pg int gzoge) ・ 


io.h 


creat は , 新しい ファ イル を 作成 する か ,、 ある い は すでに 存在 する ファ イル 
を 書き な お す た め に 使用 し ます 。 フ ァイル 名 は , pg が 指す 文字 列 で す 。 
ei9de は 、 ファ イル を 新た に 作成 する と き に の み 用 いら れ ま す 。 

creat に よっ て 作成 され る ファ イル は 、 常に グロ ー バ ル 変 数 7zoge に よ 
っ て 指定 され る 変換 モー ド (O_ TEXT また は O BINARY) て 作成 され ま 
す 。 

ファ イル が すでに 存在 し て いて , 書き 込み 属性 が セッ ト さ れ て いる 場合 に 
は , creat は その ファ イル の サイ ズ を 0 に し て , 属 性 は その まま 変更 し ませ 
ん 。 すでに 存在 し て いる ファ イル が 読み 出し 専用 属性 で ある と , creat の 呼 
び 出 し は エラ ー と な り , その ファ イル は 変更 され ませ ん 。 

creat の 呼び 出し で は 、 ア クセ スモ ー ド ワー ド gzzoge 内 の S IWRITE ビ 
ッ ト の み が 調 べら れ ま す 。 この ビッ ト が 1 で あれ ば , その ファ イル は 書き 込 
み が 可 能 で す 。 この ビッ ト が 0 で あれ ば 読み 出し 専用 に な り ま す 。 これ 以外 
の DOS の 属性 は 、 すべ て 0 に セット され ます 。 

goe に は , 以下 の 値 の いずれ か を 指定 し ます (sys\stat.h の 中 で 定義 さ 
れ て いま す )。 


2709e の 値 アク セス 許可 
S_ IWRITE 書き 込み 可 
S_IREAD 読み 出し 可 


S_IREAD | SIWRITE 読み 出し / 書 き 込 み 可 
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戻り 値 


可 搬性 


注意 : MSJDOS で は , 書き 込み 可 で あれ ば 同時 に 読み 出し も 可 に な り ま 
す 。 


動作 に 成功 し た 場合 に は , 新しい ファ イル ハン ドル ( 負 で な い 整 数 ) が 返 
きれ, エラ ー の 場合 に は -1 が 返さ れ ま す 。 
エラ ー が あっ た 場合 . er7yzzo に は 次 の いずれ か の 値 が セッ ト さ れ ま す 。 


ENOENT バス 名 また は ファ イル 名 が 見 つか ら な い 
EMFILE オー プン され て いる ファ イル が 多 す ぎる 
EACCES アク セス は 許可 きれ て いな い 


creat は UNIX シス テム で 使用 で きま す 。 


chmod, chsize、 close、 create、 creatnew、creattemp, dup, dup2, 


_ 7zoge (変数 )、 fopen、 open, sopen, write 
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creatnew 
機能 新しい ファ イル を 作成 し ます 。 
形式 #include <dos.h> 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 
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int creatnew(const char *※ pg7, int g7 の め ) : 
joh 


reatnew は 、 creat と ほとんど 同じ で す 。 異な る 点 は , 指定 し た ファ イル 
が すでに 存在 し て いる 場合 に は creatnew の 呼び 出し は エラ ー と な り 、 そ 
の ファ イル は 変化 を 受け な いと いう こと で す 。 

creatnew の 引数 7 み め に は , (dos.h の 中 で 定義 され て いる ) 以 下 に 示す 定 
数 の いずれ か を 指定 し ます 。 


FA_RDONLY 読み 出し 専用 
FA_HIDDEN 。 隠し ファ イル 
FA_SYSTEM ” シス テム ファ イル 


動作 に 成功 し た 場合 に は 新しい ファ イル ハン ドル ( 負 で な い 整 数 ) が 返 
され , エラ ー の 場合 に は -1 が 返さ れ ま す 。 
エラ ー が あっ た 場合 eryzo に は 次 の いずれ か の 値 が セッ ト さ れ ま す 。 
EEXIT すでに ファ イル が 存在 する 
ENOENT バス 名 また は ファ イル 名 が 見 つか ら な い 
EMFILE オー プン され て いる ファ イル が 多 す ぎる 
EACCES アク セス は 許可 る れ て いな い 


creatnew は MS-DOS 3.0 に 特有 の 関数 で ,、 それ より 前 の バー ジョ ン の 
DOS で は 動作 し ませ ん 。 


close, creat、 creat, creattemp, dup, 7yzoge( 変 数 )、 open 
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ーー③@ 
creattemp 


機能 指定 され た ディ レク トリ 中 に ユニ ー ク な ファ イル を 作成 し ます 。 


形式 #include <dos.h> 
int creattemp(char * pg が, int 7 の め ) : 


プロ ト タ イ プ joh 

解説 creattemp に よっ て 作成 され る ファ イル は , 常に グロ ー バ ル 変 数 oge 
で 指定 され て いる 変換 モー ド (0 TEXT また は O BINARY) て 作成 され 
ます 。 


引数 pe は パス 名 で , 最後 に 円 記号 (\) を つけ ます 。pg/ に 指定 され た 
ディ レク トリ の 中 で ユニ ー ク な (存在 する どの ファ イル と も 一 致し な い ) 
適当 な ファ イル 名 が つけ られ ます 。 作 成 され た ファ イル 名 は pg が 指す 場 
所 に お さめ られ ます 。/g 記 は 、 結 果 と な る ファ イル 名 を 格納 する の に 充分 
な 大 きき が な けれ ば な り ま せん 。 作成 され た ファ イル は , プロ グラ ム が 終 
了 す る と き に , 自動 的 に 削除 され る と いう こと は あり ませ ん 。 

creattemp は , DOS の 属性 ワー ド gzy め を 引数 に と り ま す 。 creat の 呼び 
出し で は , どの 属性 ビッ ト も セッ ト す る こと が で きま す 。 フ ァイル は ,。 常 
に バイ ナリ モー ド で オー プン され ます 。 フ ァイル の 作成 に 成功 すれ ば , フ 
ァイル ポイ ンタ は ファ イル の 先頭 に セッ ト さ れ ま す 。 フ ァイル は , 読み 込 
みろ / 書 き 込 み 可 で オー プン され ます 。 

g7 の め に は , 以下 に 示す 定数 の いずれ か を 指定 し ます (これ ら は dosh の 中 
で 定義 きれ て いま す )。 


FA RDONLY 読み 出し 専用 


FA HIDDEN 。 隠し ファ イル 
FA SYSTEM ” シス テム ファ イル 
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戻り 値 動作 に 成功 し た 場合 に は , 新しい ファ イル ハン ドル ( 負 で な い 整 数 ) が 返 
され , エラ ー の 場合 に は -1 が 返さ れ ま す 。 
エラ ー が あっ た 場合 errzo に は 大 の い ずれ か の 値 が セッ ト され ます 。 


ENOENT バス 名 また は ファ イル 名 が 見 つか ら な い 
EMFILE ォ オープン され て いる ファ イル が 多 すぎ る 


EACCES アク セス は 許可 きれ て いな い 


可 搬性 creattemp は MS-DOS 3.0 に 特有 の 関数 で 、 それ よ り 前 の バー ジョ ン の 
DOS で は 動作 し ませ ん 。 


関連 項目 close, creat、 creat, creatnew、dup, 7yzoge (変数)、open 
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cscanf 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 


コン ソー ル か ら 書 式 つき 入力 を 行ない ます 。 


int cscanf(char * 76rzg7 [gg の esy,…]) : 


conio.h 


cscanf は , 一 連 の 入力 フィ ー ル ド を スキ ャ ン し て , 一 度 に 1 文字 ずつ コン ソ 

ー ル か ら 直 接 文 字 を 読み 込み ます 。 次 に , 引数 pg7 に よっ て 指 さ れ る 書 
式 文字 列 中 の 書式 指定 に し た が っ て , 各 フ ィ ー ル ド を 書式 化し ます 。 最後 
に , 76yyig7 の 後に 続く 各 引 数 が 示し て いる アド レス に , 書式 化し た 入力 を 

格納 し て いき ます 。 入力 は 画面 に 直接 エコ ー さ れ ま す 。 書 式 文字 列 中 の 書 
式 指定 の 個数 は 、 その 後に 続く アド レス の 数 と 同じ で を けれ ば な り ま せん 。 
書式 指定 も 含め て , 詳細 な 情報 に つい て は scanf の 解説 を 参照 し て くだ さ 

い 。 

cscanf は 、 通常 の フィ ー ル ド の 終了 (ホワ イト スペ ー ス ) に 達する 前 に , 

フィ ー ル ド の スキ ャ ン を や め る 場合 が あり ます 。 ま た , いく つか の 理由 か 
ら 入 力 を 終了 し て し まう こと も あり ます 。 こ うし た 問題 に つい て は scanf 
の 解説 を 参照 し て くだ さい 。 


cscanf は 、 正 し く ス キャ ン し , 変換 し , 格納 で きた 入力 フィ ー ル ド の 数 を 
返し ます 。 戻 り 値 に は , 値 が 格納 され なか っ た 入力 フィ ー ル ド の 数 は 含ま 
れ ま せん 。 値 が 格納 され た フィ ー ル ド が な か っ た 場合 は , 戻り 値 は 0 に な り 
ます 。 
cseanf が ファ イル エン ド を 読み 込 も うと し た 場合 戻り 値 は EOF に な り 
ます 。 


cscanf は UNIX シス テム で 使用 で き , KK&R で 定義 8 れ て いま す 。 


fscanf, getche, scanf, sscanf 
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プロ ト タ イ プ 


解説 


戻り 値 
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日 付 と 時 刻 を 文字 列 に 変換 し ます 。 


#include <time.h> 
char * ctime(const time t *※ ye) : 


time.h 


ctime は , 42e が 指し て いる 時 刻 値 (time 関数 な ど に よっ て 返さ れ た も の ) 
を , 次 の よう な 最後 に 改行 と メル 文字 の つい た 26 文 字 の 文字 列 に 変換 し ま 
す 。 


IMon Nov 21 11:31:54 1983\nyO 


各 フ ィ ー ル ド の 幅 は 固定 で す 。 

long 型 の グロ ー バ ル 変 数 が ezoze は , GMT と その 地方 の 標準 時 の 差 を 
秒 単位 で 保持 し て いま す (PSTー 太 平 洋 標準 時 の 場合 に は 8X60X60)。 グ 
ロー バル 変数 ggg7g7 は , 米国 の 夏時間 の 期間 中 に の み 0 以 外 の 値 を と る 
よう に な っ て いま す 。 


ctime は 日 付 と 時 刻 を 持つ 文字 列 を 指す ポイ ンタ を 返し ます 。 戻 り 値 は 静 
的 デー タ を 指し て お り , これ は 呼び 出し が 行なわ れる ご と に 上 書き され ま 
す 。 


ctime は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 


asctime, dgg/zg7 (変数 )、 difftime、 ftime, getdate、 gmtime, 
1ocaltime, settime, time, が zezoe (変数 )、 tzset 


asctime を 参照 し て くだ さい 。 
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ctrlbrk 


形式 


プ ブ プロトタイプ 


解説 


戻り 値 


可 搬性 


関連 項目 


コン トロ ー ル プレー クハ ンド ラ を セッ ト し ます 。 


Yoid ctrlbrk(int (* gzger) (void) ) : 


dos.h 


ctrlbrk は , Agzg7er が 指す 関数 を 新た な コン トロ ー ル プレ ー ク ハン ドラ 

と し て セッ ト し ます 。 割 り 込み ベク タ 0x23 は 、 この 関数 を 呼び 出す よう に 

変更 きれ ます 。 

ctrlbrk は 、 この 関数 を 呼び 出す DOS の 割り 込み ハン ドラ を 作り あげ ま 

す 。 こ の 関数 が 直接 呼び 出さ れる こと は あり ませ ん 。 

ハン ドラ 関数 は 、 どん な 操作 や シス テム コー ル を 行なっ て も か まい ませ ん 。 
ハン ドラ は , 必 ら ず し も 元 の 位置 に 戻る 必要 は な く , longjmp を 使っ て プ 
ログ ラム 内 の 任意 の 場所 に 戻る こと が で きま す 。 ハ ンド ラ 関 数 が 0 を 返す と 

プロ グラ ム は 異常 終了 し ます 。 0 以外 の 値 を 返し た 場合 に は , プロ グラ ム の 
実行 が 再開 され ます 。 


ctrlbrk は 何 も 返 し ませ ん 。 


ctrlbrk は MS-DOS に 特有 の 関数 で す 。 


getcbrk、 signal 
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例 1nc1ude <stdto.h> 
#1nc1ude <dos.h> 


#define ABORT 0 

nt c_break(vo1d) 

【 
printE("Contro1-Break hit. Program abortng ...\n'): 
return(ABORT): 


} 


main() 
{ 
ctr1brk(c_break) : 
for (ii) て /* 無限 ルー プ +/ 
printf(*Looping ...\n*)i 
} 


プロ グラ ム 出 力 
Looplng ... 
Looping 
Looping 


Contro1-Break hit. Program aborting ... 
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delay 


名 前 実行 を 一 時 停止 させ ます 。 

形式 void delay (unsigned zz が secoz の s) : 

プロ ト タ イ プ dosh 

機能 説明 delay を 呼び 出す と , 現在 実行 中 の プロ グラ ム は 引数 刀 記 isecoz の s で 指定 し 
た ミリ 秒 数 だ け 実 行 を 一 時 停止 し ます 。 正 確 な 停止 時 間 は , 動作 環境 が 異 
な る と 多少 変化 する こと が あり ます 。 


戻り 値 あり ませ ん 。 


可 搬性 この 関数 は PC-9801 (また は IBM PC お よび その 互換 機 ) で の み 動き ま 
す 。 


関連 項目 nosound, sleep, sound 
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mn 
difftime 


機能 2 つの 時 刻 の 差 を 計算 し ます 。 


形式 #include <time.h> 
double difftime (time_t 7ze2, time t 7ze7) : 


プロ ト タ イ プ timeh 


解説 difftime は 、 7 が ie7 か ら が ie2 まで の 経過 時 間 を 秒 単位 で 計算 し ます 。 
long 型 の グロ ー バ ル 変 数 が 7zezoze は 、GMT と その 地方 の 標準 時 の 差 を 
秒 単位 で 保持 し て いま す (PST 一 太平 洋 標準 時 の 場合 に は 8X60X60)。 グ 
ロー バル 変数 dgg7g7 は , 米国 夏時間 の 期間 中 に の み 0 以 外 の 値 を と る よ 
うに な っ て いま す 。 


戻り 値 difftime は 計算 の 結果 を double で 返し ます 。 
可 搬性 difftime は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 
関連 項目 asctime, ctime, gog/ig ん (変数 )、time, が が zzezoze( 変 数) 
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disable 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


割り 込み を 不可 に し ます 。 


#include <dos.h> 
void disable(void) : 


dos.h 

disable は , ハ ー ド ウェ ア 割 り 込 み の 制御 が 和 柔軟 に 行 な を と る よう に 用 意 きれ 
て いま す 。 

disable マク ロ は 割り 込み を 不可 に し ます 。 ど ん な 外部 デバ イス か ら で も , 
NMI 割り 込み (non-maskable interrupt) の み が 許 され る こと に な り ま 
す 。 

戻り 値 は あり ませ ん 。 


disable マク ロ は 80x86 ア ー キ テク チャ に 特有 の 関数 で す 。 


enable、 getvect 
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形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


例 
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2 つの 整数 の 除算 を 行なっ て , 商 と 剰余 を 返し ます 。 


#include <stdlib.h> 


div t div(int zzze/, int の ezo77) : 
stdlib.h 


div は 2 つの 整数 の 除算 を 行なっ て , 商 と 剰余 を div 《 型 と し て 返し ます 。 
ie/ と dezoyi は 、 それ ぞ れ 非 除 数 と 除 数 で す 。div 《t 型 は 整数 の 構造 体 
で , stdlib.h の 中 で 次 の よう に typedef 宣言 され て いま す 。 


typedef struct ( 


1nt quot: な 商 。*/ 
nt remi /* 笛 余 メ / 
) div_ ti 


div は , go/ ( 商 ) と 7ez (剰余 ) を 要素 に 持つ 構造 体 を 返し ます 。 


dv は ANSI C と 互換 性 が あり ます 。 


ldiv 


#include <std1ib.h> 
div_t xi 
main() 
6 
テ = diV(10.3)』 


PrintE("10 div 3 = zd remainder Zd\n"。 x.quot。 xrem) : 
} 


プロ グラ ム 出 力 


10 div 3 = 3 remainder 1 
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dosexterr 


機能 DOS の 拡張 エラ ー 情 報 を 得 ます 。 


形式 #include <dos.h> 
int dosexterr(struct DOSERROR * ep) : 


プロ ト タ イ プ dosh 


解説 この 関数 は , DOS の シス テム コー ル が 不 成 功 に 終わ っ た 場合 に , 拡張 エラ 
ー 情 報 を , ep/&p が 指す DOSERROR 構造 体 に 埋め 込み ます 。 こ の 構造 体 
は 次 の よ うに 定義 きれ て いま す 。 


struct DOSERROR { 


1nt exterrOori /* 拡張 エラ ー +#/ 
char classi /* エラ ー ク ラス */ 
char actioni /* 動作 4 
char 1ocuSi /* エラ ー の 位置 */ 


} 


この 構造 体 の 各 値 は 、 DOS の シス テム コー ル 0Ox59 を 通じ て 取得 され ます 。 
exeyor の 値 が 0 で あれ ば , その 前 に 行なわ れ た DOS コー ル は エラ ー に な 
ら な か っ た こと を 意味 し ます 。 


戻り 値 dosexterr は 、DOSERROR 構造 体 中 の ex/eyzor の 値 を 返し ます 。 
可 搬性 dosexterr は MS-DOS 3.0 に 特有 の 関数 で . それ 以前 の バー ジョ ン で は 動 
作 し ませ ん 。 
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ーー 
dostounix 


機能 日 付 と 時 刻 を UNIX の 時 刻 書式 に 変換 し ます 。 


形式 #include <dos.h> 
long dostounix (struct date * 9,struct time * 7) : 


プロ ト タ イ プ dosh 

解説 dostounix は , getdate と gettime で 得 た 日 付 と 時 刻 を UNIX の 書式 に 変 
換 し ます 。 9 は date 構造 体 を 。7 は time 構造 体 を 指し て お り , 2 つの 構造 
体 は それ ぞ れ 有 効 な DOS の 日 付 お よび 時 刻 に 関す る 情報 を 含ん で い る と 
し まま 。 


戻り 値 dostounix は UNIX 形式 の 現在 時 刻 つま り 1970 年 1 月 1 日 午前 0 時 (CMT) 
か ら の 経過 時 間 を 秒 数 で 表わし た も の が 返さ れ ま す 。 


可 搬性 dostounix は MS-DOS 特有 の 関数 で す 。 


関連 項目 unixtodos 
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機能 ファ イル ハン ドル を 複製 し ます 。 
形式 int dup(int gzg/e) 
プロ ト タ イ プ ioh 


解説 dup は , 元 の ファ イル ハン ドル と 次 の よう な 共通 点 を 持つ 新しい ファ イル 
ハン ドル を 返し ます 。 


一 同じ オー プン ファ イル ある い は デバ イス 

較 司 じ フ ァイル ポイ ンタ (つま り 、 一 方 の ファ イル ポイ ンタ を 変更 する 
と , も う 一 方 も 変更 きれ ます ) 

較 同 じ ア クセ スモ ー ド (読み 出し 、 書き 込み 、 読 み 出し / 書 き 込 み ) 


引数 42zde は creat, creat, open, open、dup、dup2 の 呼び 出し で 
得 ら れ た ファ イル ハン ドル で す 。 


戻り 値 成功 し た 場合 , dup は 新しい ファ イル ハン ドル ( 負 で な い 整 数 ) を 返し 、 エ 
ラー の 場合 は -1 を 返し ます 。 


エラ ー の 場合 。 eryzzo は 次 の いずれ か に セッ ト さ れ ま す 。 


EMFILE オー プン ファ イル が 多 す ぎる 
EBADF ファ イル 番号 が 正しく な い 


可 搬性 dup は すべ て の UNIX シス テム て で 使用 で きま す 。 


関連 項目 close, close, creat, creat、 creatnew、 creattemp, dup2, 
fopen、 open,。 open 
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dup2 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 
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ファ イル ハン ドル を 既存 の ファ イル ハン ドル に 複製 し ます 。 


int dup2(int oz の 7e, int 7ewgzg/e) ・ 


io.h 


dup2 は , 元 の ファ イル ハン ドル と 次 の よう な 共通 点 を 持つ 新しい ファ イル 
ハン ドル を 作成 し ます 。 


田 同 に オー プン ファ イル ある い は デバ イス 

田 同 に ファ イル ポイ ンタ (つま り , 一 方 の ファ イル ポイ ンタ を 変更 する 
と , も う 一 方 も 変更 され ます ) 

田 同 じ ア クセ スモ ー ド (読み 出し , 書き 込み , 読み 出し / 書 き 込 み ) 


dup2 は 、 zewgzg/e の 値 を も つ 新 し い フ ァイル ハン ドル を 作成 し ます 。 
dup2 が 呼び 出さ きれ た と き に , zewgzge に 結び つけ られ た ファ イル が オー 
プン され て いる 場合 は 、 そ の ファ イル は クロ ー ズ され ます 。 

zewgzgd/e と ogzd7e は 、creat、open、dup, dup2 の 呼び 出し で 得 ら れ 
た ファ イル ハン ドル で す 。 


dup2 は 成功 し た 場合 は 0 を 返し ,. エラ ー の 場合 は -1 を 返し ます 。 
エラ ー の 場合 , er7zo は 次 の いずれ か に セッ ト さ れ ま す 。 


EMFILE オー プン ファ イル が 多 す ぎる 
EBADF ファ イル 番号 が 正しく な い 


dup2 は いく つか の UNIX シス テム で 使用 で てき ます 。 た だ し , System III で 
は 使用 で きま せん 。 


_close, close, creat, creat, creatnew, creattemp。 dup, 


fopen,、 open, open 
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ecvt 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 


浮動 小数 点数 を 文字 列 に 変換 し ます 。 


char * ecvt(double yg/e, int 7 の g, int ※ dec, int * SgZ) : 


stdlib.h 


ecvt は , yg/e の 値 を , 一 番 左 の 有効 桁 か ら 始ま り ヌ ル で 終わ る djg 桁 の 
文字 列 に 変換 し , その 文字 列 を 指す ポイ ンタ を 返し ます 。 小 数 点 が 文字 列 
の 先頭 か ら 何 桁 目 に ある か は , gec を 通し て 間接 的 に 格納 され ます (gec が 
負 の 場合 は 、 返さ れ た 最初 の 数 字 の 左 に 小数 点 が ある こと を 意味 し ます )。 
小数 点 は 文字 列 そ の も の に は 含ま れ ま せん 。 結果 の 符号 が 負 の と き は 。 sjg ヵ 
が 指す ワー ド は 0 で な く な り , それ 以外 の と き は 0 と な り ま す 。 下位 の 桁 は 
四捨五入 され ます 。 


ecvt の 戻り 値 は 静 的 デー タ を 指し て いる の で , ecvt が 呼ば れる た びに , そ 
の 内 容 は 上 書き され ます 。 


ecvt は UNIX シス テム で 使用 で きま す 。 


atof, atoi, atol, fcvt, gcvt、 printf 


Turbo C 標 準 関数 リフ ァ レ ンス 115 


構文 


プロ ト タ イ プ 


説明 


116 


リテラ ル 値 を 直接 コー ド に 埋め 込み ます 。 
void emit (grgwyez7, …) ・ 
dos.h 


__emit は イン ライ ン 関 数 で あり , コン パイル 時 に オプ ジェ クト コー ド 
の 中 に , リテラ ル 値 を 直接 埋め 込む た め に 使わ れ ま す 。 こ れ に よっ て , イ 
ン ラ イン アセ ンプ リ 言 語 や アセ ンプ ラ を 使わ な く て も , マシ ン 語 命令 を 生 
成す る こと が で きま す 。 イ ン ラ イン アセ ンプ リ が 使え な い 統 合 開発 環境 の 
中 で も この 関数 を 使用 で きま す 。 

一 般 的 に __emit の 呼び 出し で は 1 バイ トマ シン コー トド 命令 を 指定 し ま 
す が , この 関数 で は C の 変数 の 参照 な を どの より 複雑 な 命令 も 使用 で きる 機 
能 を も っ て いま す 。 


警告 ! こ の 関数 は 、 80x86 プ ロ セ ッ サ ファ ミリ の 機械 語 に よく 通し て いる プ 
ログ ラマ の み が 使 用 すべ きも の で す 。 こ の 関数 を 使え ば , 関数 の 中 に 好き 
な バイ ト を 埋め 込む こと が で きま す が , も し 間違い が あれ ば プロ グラ ム は 
お か し な 動作 を 示し , 暴走 し て し まい ます 。Turbo C は , この 関数 の 呼び 
出し が 正しい か どう か は まっ た く チ ェ ッ ク し ませ ん 。 レ ジス タ や メモ リ の 
内 容 を 変更 する 命令 を 埋め 込ん だ 場合 TurboC は それ を 認識 で きず , イ 
ン ラ イン アセ ンプ リ 言 語 に お いて 多く の 場合 に な され る レジ スタ の 保存 も 
行なわ れ ま せん (た と えば , イン ライ ン 命 令 で は , SI レジ スタ お よび DI レ 
ジス タ が 使わ れ て いる こと が 認識 され ます )。 こ の 関数 を 使う 場合 は すべ て 
プロ グラ マ の 責任 と な り ま す 。 


__emit に は 少な く と も 1 個 は 引数 を 渡す 必要 が あり ます が , それ 以上 で 
あれ ば いく つ 渡 し て も か まい ませ ん 。 こ れ ら の 引数 は , 他 の 関数 呼び 出し 
に お ける 引数 と は 違う 扱い を 受け ます 。 つ まり , emit に 渡さ れる 引数 
は 変換 され る こと は あり ませ ん 。 

__emit へ の 引数 の 形式 に 対し て は 特別 を 制限 が あり ます 。 静 的 を オプ 
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戻り 値 


可 搬 性 


ジェ クト を 初期 化す る の に 使用 で きる 式 の 形式 を と っ て いな けれ ば な り ま 
せん 。 つ まり , 整数 や 浮動 小数 点 の 定数 , 静 的 な オプ ジェ クト の アド レス 
を 使う こと が で きま す 。 こ うし た 式 の 値 は 。 オプ ジェ クト コー ド 中 の 呼び 
出し の 位置 に , 初期 化 デ ー タ と し て 使用 きれ る の と まっ た < く 同じ よう に 埋 
め 込 まれ ます 。 自動 変数 や 引数 変数 の アド レス , これ ら に 定数 オフ セッ ト 
を プラ ス ま た は マイ ナス し た も の も 使用 する こと が で きま す 。 こ れ ら の 引 
数 に 対し て は , BP か ら の 変数 の オフ セッ ト が 格納 され ます 。 

オプ ジェ クト コー ド の 中 で 占め る バイ ト 数 は , 次 の 場合 を 除い て , 引数 の 
型 に よっ て 決ま り ま す 。 


田 そ の 値 が 0 か ら 255 の 範囲 の 符号 つき 整定 数 (た と えば Ox90) は , 文字 
と 同様 に 扱わ れ , 1 バイ ト を 占め ます 。 

玉 自 動 変 数 や 引数 変数 の アド レス が 使用 され る 場合 は BP か ら の 変数 
の オフ セッ ト が -128 か ら 127 の 範囲 に 入っ て いれ ば 1 バイ ト , それ 以外 
は 1 ワー ド を 占め ます 。 


1 バイ ト は 次 の よう に し て 書く こと が で きま す 。 
emit (Ox90): 


値 は 255 以 下 で も ワー ド と し て 書き た い 場 合 は , 大 の よう に キャ スト を 使う 
か , 


ーemit (OxB8, (unsigned)17): 

ある い は 次 の よう に し ます 。 

emit (OxB8, 17u): 

2 バイ ト あ る い は 4 バイ ト の アド レス は , アド レス を void near * あ る い は 


void far ネ に キャ スト する こと に よっ て 得 ら れ ま す 。 


あり ませ ん 。 


__emit は , イン テル 80x86 ア ー キ テク チャ に 特有 の 関数 で す 。 


Turbo C 標 準 関数 リフ ァ レ ンス 11Z 


enable 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 
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割り 込み を 可能 に し ます 。 


#include <dos.h> 


void enable(void) : 


dos.h 

enable は , ハー ドウ ェ ア 割 り 込 み の 制御 が 柔軟 に 行 な を る よう に 用 意 き され 
て いま す 。 

enable マク ロ は , 割り 込み を 可能 に し ます 。 これ に よっ て どの デバ イス か 
ら で も 割り 込み が で きる よう に な り ま す 。 

戻り 値 は あり ませ ん 。 


enable は 80x86 ア ー キ テク チャ に 特有 の 関数 で す 。 


disable、 getvect 
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eof 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


ファ イル エン ド か どう か を 調べ ます 。 


int eof(int gzg/e) : 


ioh 


eof は 、 gzd/e に 結び つけ られ た ファ イル が ファ イル エン ド に 到達 し て い 
る か どう か を 決定 し ます 。 


eof は , 現在 位置 が ファ イル の 終わ り で あれ ば 1 を 返し .、 そう で な けれ ば 0 を 
返し ます 。 戻 り 値 が -1 の 場合 は エラ ー を 意味 し , eryzzo に 次 の 値 が セッ ト 
され ます 。 


EBADF ファ イル 番号 が 正しく な い 


clearerr, feof, ferror、 perror 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 一 
eXeC... 


機能 他 の プロ グラ ム を ロー ド し て 実行 し ます 。 


形式 int execl(char * pg が , char * grg0, * grg7. … * gg7. NULL) : 


int execle(char * pg Char * ネ grg0, * G/g7, *※ gZg7。 NULL 


char ※ 玉 ezy) 

int execlp(char * pg7, char * grg0, * gzg7, … * grg7, NULL) : 

int execlpe(char * pg が char * grg0, * grg7, g7g7,。 NULL, 
char ※ 玉 ezy) 

int execv(char * pg が, char * ggy[]) : 

int execve(char * pg Char * grgy[]、char ** ezy) : 

int execvp(char * pg 万 , char * grgy[]) : 

int execvpe(char *※ pg の , char * gzgy[]、char ※ 来 ezy) : 


プロ ト タ イ プ process.h 


解説 exec.… フ ァ ミ リィ の 関数 は , 他 の プロ グラ ム を ロー ド し 実行 し ます 。 こ れ 
は " 子 プ ロ セ モス" と し て 知ら れ て いま す 。exec.… の 呼出 し が 成功 する と , 子 
プロ セス は "“ 親 プロ セス "に オー バー レイ し ます 。 子 プロ セス を ロー ド し て 
実行 する た め に 充分 な メモ リ 領 域 が 存在 し な けれ ば な り ま せん 。 
ZZ は 。 呼び 出さ れる 子 プ ロモ ス の ファ イル 名 で す 。 exec.… は , pg を 次 
の よう な MS-DOS 標準 の 手順 で 探し ます 。 


罰 拡 張子 も ビリ オド も な い 場 合 は 、 ま ず 与 えら れ た ファ イル 名 を 探し ま 
す 。 存 在 し な けれ ば .COM を 付加 し て 再び 探し ます 。 そ れ も 存 在 し な 
けれ ば . EXE を 付加 し て も う 一 度 探 し ます 。 

罰 拡 張子 が 与え られ た 場合 は 、 与 えら れ た と お り の ファ イル 名 を 探し ま 
す 。 

較 拡 張子 な し で ピリ オド が ある 場合 は 拡張 子 な し で ファ イル 名 を 探し 
ます 。 


exec.… に つけ られ た 接尾 辞 。 1 Y,p, e は , 次 の よう な 意味 を も っ て いま 
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p ファ イル 名 を 探す 際 に , DOS の 環境 変数 PATH に セッ ト さ れ て 
いる すべ て の ディ レク トリ を 探索 し ます (p が つい て いな い 場 合 
は , カレ ント ディ レク トリ し か 探索 され ませ ん )。 引 数 pg が に は 
っ きり と ディ レク トリ が 指定 され て いな い 場 合 に は , 最初 に カレ 
ント ディ レク トリ を 探し 、 次 に ルー トディ レク トリ を 探し ます 。 

1 引数 ポイ ンタ (gzs0, gzg7, …。 grgz) は , 別々 の 引数 と し て 渡 き 
れる こと を 意味 し ます 。 一般に , 引数 の 個数 が あら か じ め わ か っ 
て いる と き に 接尾 辞 1 が つい た も の が 使わ れ ま す 。 

Y 引数 ポイ ンタ (gzgy[0], .…… grgy[]) は , ポイ ンタ の 配列 と し 
て 渡さ きれ る こと を 意味 し ます 。 一般に , 渡さ れる 引数 の 個数 が 可 
変 の と き に 接尾 辞 Y が つい た も の が 使わ れ ま す 。 

e 引数 exy が 子 プ ロ セ ス に 渡さ れる こと を 意味 し ます 。 こ れ に よっ 
て 子 プ ロ セ ス の 環境 を 変え る こと が で きま す 。e が つか な い 場 合 、 
子 プ ロ セ ス は 親 プ ロ セ ス の 環境 を 受け つぎ ます 。 


exec.… フ ァ ミ リィ の 各 関 数 は 引数 に 関す る 指定 を 行なう 2 つの 接尾 辞 (1 
また は y) の いずれ か を 含ん で いな けれ ば な り ま せん 。 パス の サー ナチ 手順 と 
環境 の 受け つぎ 方 に 関す る 接尾 辞 (p と e) は オプ ショ ン で , な く て も か ま 
いま せん 。 

た と えば 療 の よう に な り ま す 。 


田 execl は , 別々 の 引数 を 受け 取り , ルー ト と 現在 の 作業 ディ レク トリ の 
み を サー チ し , 子 プ ロモ セス は 親 プ ロ セ ス の 環境 を 受け 継ぐ 。 

較 execvpe は , 引数 ポイ ンタ の 配列 を 受け 取り , PATH で 指定 され た デ 
ィ レ クト リ を サー チレ し , 子 プ ロ セ ス の 環境 を 変え る た め に ezy を 受け 
取る 。 


exec.… 関 数 は , 子 プ ロモ セス へ 渡す 引数 を 少な く と も 1 個 (Zrg0 あるいは 
grgy[0]) 持 た な く て は な り ま せん 。 こ の 引数 は 慣習 で 普通 は pg の コピ ー 
で す ( 別 の 値 を 使っ て も エラ ー に は な り ま せん が )。 MS-DOS 3.* で は , 子 
プロ セス で pg を 使用 する こと が で きま す が , それ より 前 の バー ジョ ン で 
は 0 番目 の 引数 (Zrg0 また は ergy[0]) の 渡さ れ た 値 を 使う こと は で きま せ 
ん 。 
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接尾 辞 1 が 使わ れ て いる 場合 , grg0 は 通常 pg を 指し , grg7,…, の 7g7 は 新 
し ゅ 引数 リス ト を 形成 する 文字 列 を 指し ます 。 grgz の 次 の 引数 NULL は 
必 ら ず 必 要 で , リス ト の 終わ り を 示し ます 。 

接尾 辞 e が 使わ れ て いる 場合 , 新しい 環境 変数 の リス ト を 引数 ezy で 渡す 
こと が で きま す 。 ezy は char ポイ ンタ の 配列 で , 各 要 素 は ヌル で 終わ る 次 
の よう な 文字 列 を 指し て いま す 。 


envvar = Yalue 


ezyygr は 環境 変数 の 名 前 で あり , yg/ze は ezyygr に セッ ト さ れる 文字 列 で 
す 。 eny の 最後 の 要素 に は NULL が 入り ます 。 ey が NULL の 場合 , 子 プ 
ロモ セス は 親 プ ロ セ ス の 環境 設定 を 受け つぎ ます 。 

gg0 十 の g7 十 ... 填 の gz( あ る い は grgy[0] 十 grgy[1] 二 . の gy[z]) の 長 
さ は , 区 切り の 空白 も 含め て 128 バ イト より 短く な く て は な り ま せん 。 ヌル 
文字 は これ に は 含め ませ ん 。 exec.… 関 数 が 呼び 出さ れ た と き , オー プン さき 
れ て いる ファ イル は その まま に な り ま す 。 


戻り 値 成功 し た 場合 exec.… 関 数 は 値 を 返し ませ ん 。 エ ラー の 場合 は -1 を 返し , 
eryzzo に は 次 の いずれ か が セッ ト さ れ ま す 。 


E2BIG 引数 リス ト が 長 すぎ る 

EACCES アク セス 許可 が 否定 され て いる 

EMFILE オー プン され て いる ファ イル が 多 す ぎる 
ENOENT パス 名 ある い は ファ イル 名 が 見 つか ら な い 


ENOEXEC exec 書式 エラ ー 
ENOMEM メモ リ が 不足 し た 


可 搬性 exec… は MS-DOS 特有 の 関数 で す 。 


関連 項目 abort、 atexit,. exit、 exit、 fpreset, searchpath. 
SDaWn.…, SyStem 
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例 nc1ude <etdio.h> 
旭 nc1ude <process.h> 


main() 
6 
1nt stati 


printf("About to exec chi1d with arg1 arg2 "nr)i 
stat = exec1("CHTLD.EXE* 。 *CHILD.EXE* 。 "arg1" 。 "arg2" 。 NULL): 


/* exec1 は CHTLD を 実行 で き な か っ た 場合 に の み 制 御 を 戻す メ / 
Printf("exec1("exec1 error = Zd\n"。 stat): 
exit(1): 

} 


/* CHTLD.C */ 
ま #1nclude <stdio.h> 


main(int argc,。 Char *argy[1] 


6 
nt ii 
Printf("Ch11d running ・..\n"): 
for (is=0: <argci ミキ +) /* 引数 を 表示 */ 
PrintE("argv[Zd]: Zswn'。 1。 argv[1]): 
} 
プロ グラ ム 出 力 


About to exec chi1d with arg1 arg2 ... 
Chi1d running ..・ 

argy[0]: CHTLD.EXE 

argv[1]: arg1 

ar&V[2]: arg2 
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_exit 

機能 プロ グラ ム を 終了 させ ます 。 

形式 void exit(int srgrs) : 

プロ ト タ イ プ process.h, stdlib.h 

解説 _exit は 、 フ ァイル の クロ ー ズ , 出力 の フラ ッシュ , 終了 時 関数 の 呼び 出し 
を いっ さい 行なわ ず に プロ セス を 終了 させ ます 。 
引数 gks は 、 プ ロ セ ス の 終了 ステ ー タ ス と し て 呼び 出し た プロ セス に 供 
給 され ます 。 一 般 的 に は 0 は 正常 終了 を 示し , 0 以外 の 値 は エラ ー を 示す 
た め に 使わ れ ます 。 

戻り 値 戻り 値 は あり ませ ん 。 

可 搬性 _exit は UNIX シス テム で 使用 で きま す 。 

関連 項目 abort。 atexit。 exec.… exit、 spawn.… 
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exit 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


プロ グラ ム を 終了 させ ます 。 

void exit(int sfg/S) ・ 

prosess.h、 stdlib.h 

exit は , この 関数 を 呼び 出し た プロ セス を 終了 させ ます 。 終 了 す る 前 に , 
すべ て の オー プン され て いる ファ イル は クロ ー ズ され , バッ ファ の 中 の 出 
力 (出力 され る の を 待っ て いる ) は 書き 出さ れ , 登録 され て いる "終了 時 関 
数 "(atexit を 参照 ) が 呼び 出さ れ ま す 。 

引数 s42ks は 、 プ ロ セ ス の 終了 ステ ー タ ス と し て 呼び 出し た プロ セス に 供 
給 さ れ ま す 。 一 般 的 に は , 0 は 正常 終了 を 示し , 0 以外 の 値 は エラ ー を 示す 
た め に 使わ れ ま す 。 

戻り 値 は あり ませ ん 。 


exit は UNIX シス テム で 使用 で き 、 ANSI C と 互換 性 が あり ます 。 


abort、 atexit、 exec.…, exit keep, Signal, spawn.… 
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eXD 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 
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指数 関数 e の * 乗 を 返し ます 。 


#include <math.h> 
double exp(double *) : 


math.h 

exp は , 指数 関数 e* を 計算 し ます 。 

exp は , e" を 返し ます 。 

引数 の 値 に よっ て は , オー バー フロ ー が 起こ っ た り , 計算 で き な い こと が 
あり ます 。 オー バー フロ ー が 起き た 場合 , exp と pow は HUGE VAL を 返 
し ます 。 大き さ が 非 常に 大 きい 結果 は eryzo に 次 の 値 を セッ ト し ます 。 


ERANGE 結果 が 指定 の 範囲 を 越え た 


オー バー フロ ー の 場合 に は exp は 0.0 を 返し , er7zzo は 変更 され ませ ん 。 
exp の エラ ー 処 理 は 、 matherr 関数 を 使っ て 変更 する こと が で きま す 。 


exp は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


frexp、ldexp、log, log10, matherr、pow、pow10, sqrt 
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fabs 


機能 浮動 小数 点数 の 絶対 値 を 返し ます 。 


形式 #include <math.hy 
double fabs(double *) : 


プロ ト タ イ プ mathh 


解説 fabs は 、 double 型 の 引数 x の 絶対 値 を 計算 し ます 。 
戻り 値 fabs は , * の 絶対 値 を 返し ます 。 エ ラー の 戻り 値 は あり ませ ん 。 
可 搬性 fabs は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


関連 項目 abs, cabs、 labs 
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farcalloc 
機能 ヒー プ か ら メ モリ を 割り 当て る 
形式 Yoid far * farcalloc (unsigned ong Zzz が, unsigned long ZZ が sz) : 
プロ ト タ イ プ allocc 
解説 farcalloc は 、far ヒー プ か ら 各 要素 が isz バイ ト で, 要素 の 数 が zu 
の 配列 用 の メモ リ を 割り 当て ます 。 
far ヒー プ か ら 割 り 当 て に 関し て は 。 療 の 点 に 注意 し て くだ さい 。 
田 利 用 可能 な RAM は すべ て 割り 当て る こと が で きる 。 
較 64K バイ ト を 超え る プロ ッ ク を 割り 当て る こと が で きる 。 
罰 割 り 当 て られ た プロ ッ ク を アク セス する に は far ポイ ンタ が 使用 され 
る 。 
コン シバ クト , ラー ジ , ヒュ ー ジ メモ リモ デル で は , farcalloc は , calloc と 
まっ た く 同 じ で は あり ませ ん が よく 似 て いま す 。farcalloc は unsigned 
long の 引数 を と る の に 対し , calloc は unsigned の 引数 を と り ま す 。 
タイ ニ ィ モデ ル で は , プロ グラ ム を .COM ファ イル に 変換 する 場合 に は 。 
farcalloc を 使う こと は で きま せん 。 
戻り 値 farcalloc は 新た に 割り 当て られ た ブロック を 指す ポイ ンタ を 返し ます 。 
要求 し た 大 き さ の メモ リ 領 域 を 割り 当て る こと が で き な か っ た 場合 に は 
NULL を 返し ます 。 
可 搬性 farcalloc は MS-DOS に 特有 の 関数 で す 。 
関連 項目 calloc、farcoreleft。 farfree、 malloc 
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farcoreleft 


プロ ト タ イ プ 


戻り 値 


far ヒー プ の 未 使用 メモ リ の 量 を 返し ます 。 

unsigned long farcoreleft (void) : 

alloc.h 

farcoreleft は 、far ヒー ブ 中 の 割り 当て 済み の 最高 位 ア ロッ ク の 上 に ある 
未 使用 メモ リ の 量 を 返し ます 。 

タイ ニ ィ モデ ル で は , プロ グラ ム を .COM ファ イル に 変換 する 場合 に は , 


farcoreleft を 使う こと は で きま せん 。 


farcoreleft は 割り 当て 済み の 最高 位 ア ロッ ク と メモ リ の 終わ り の 間 の 未 
使用 領域 の 量 を 返し ます 。 


farcoreleft は MS-DOS に 特有 の も の で す 。 


coreleft、 farcalloc、 farmalloc 


farmalloc を 参照 し て くだ さい 。 
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ーーー ニー ニー ーー ーー ニー ニー ニニ ミー ミミー = モミ 
farfree 


機能 far ヒー プ か ら ブ ロッ ク を 1 個 解 放し ます 。 

形式 void farfree(void far * block) : 

プロ ト タ イ プ alloc.h 

解脱 farfree は , 以前 に far ヒー プ に 割り 当て られ た メモ リプ ロッ ク を 解放 し 
ES ュ 記 
タイ ニ ィ モデ ル で は , プロ グラ ム を .COM ファ イル に 変換 する 場合 に は , 
farfree を 使う こと は で きま せん 。 
スモ ー ル お よび ミディ アム モデ ル で は , farmalloc で 割り 当て られ た プロ 
ッ ク は , 通常 の free で は 解放 され ませ ん 。 ま た malloc で 割り 当て られ た 
プ ブロッ ク は , farfree で は 解放 で きま せん 。 こ れ ら の モデ ル で は , 2 つの 上 
ー プ は まっ た く 別 物 と いう こと に な り ま す 。 

戻り 値 戻り 値 は あり ませ ん 。 

可 搬性 farfree は MS-DOS に 特有 の 関数 で す 。 


関連 項目 farcalloc, farmalloc 


例 farmalloc を 参照 し て くだ さい 。 
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farmalloc 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


far ヒー プ に メモ リ を 割り 当て ます 。 


void far * farmalloc (unsigned long 7 の yes) : 


alloc.h 


farmalloc は ,、 far ヒー プ か ら z の yes バイ ト の 長き の メモ リプ ブロ ッ ク を 割 
り 当 て ます 。 
far ヒー プ か ら の 割り 当て に 関し て は , 次 の 点 に 注意 し て くだ さい 。 


田 利 用 可能 な RAM は すべ て 割り 当て る こと が で きる 。 

較 64K バイ ト を 超え る ブロ ッ ク を 割り 当て る こと が で きる 。 

脅 割 り 当 て られ た プロ ッ ク を アク セス する に は far ポイ ンタ が 使用 され 
る 。 


コン パクト 、 ラー ジ , ヒュ ー ジ メモ リモ デル で は , farmalloc は 、 malloc 
と まっ た く 同 じ で は あり ませ ん が よく 似 て いま す 。 farmalloc は unsigned 
long の 引数 を と る の に 対し , malloc は unsigned の 引数 を と り ま す 。 


. タ イニ ィ モ デル で は , プロ グラ ム を .COM ファ イル に 変換 する 場合 に は , 


farmalloc を 使う こと は で きま せん 。 

farmalloc は , 新た に 割り 当て られ た プロ ッ ク を 指す ポイ ンタ を 返し ます 。 
要求 し た 大 き さ の メモ リ 領 域 を 割り 当て る こと が で き な か っ た 場合 に は 
NULL を 返し ます 。 


farmalloc は MS-DOS に 特有 の 関数 で す 。 


farcalloc, farcoreleft. farfree、farrealloc、malloc 
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far メ モリ 管理 


farcoreleft - メモ リ の 残り 容量 を 得る 
farmalloc  - far ヒ ー プ に 領域 を 割り 当て る 
farrea11oc - far ヒ ー プ の プロ ッ ク を 調整 する 
Farfree - Ear ヒー プ を 解放 する 

に 7 

すま include <stdio.h> 

#include <a11oc.h> 


matn() 

{ 
char far *blocki 
1ong size = 65000: 


/* 残り 領域 を 調べ る */ 
Printf("z1u bytes freewn*。 farcoreleft()): 


/* その 一 部 を 得る */ 

b1ock = farmal1oc(slze): 

1f (bl1ock == NULL) 

【 
PrintE("falled to al11ocate\n* ) : 
exit(1)j 

} 

Printf("Z1u bytes a11ocated。 "size): 

Printf("Z1u bytes Ereewn"。 Farcoreleft( ) ) 


/* ブロ ッ ク を 調整 */ 

stze /= 25 

block = farreal1loc(block。 slze): 

printf("block now rea11ocated to Z1u bytes, "。 size)i 
PrintE("Z1u bytes Eree\n"。 Farcoreleft()): 


/* すべ て を 解放 */ 

Printf(*Free the b1ockn*): 

farfree(b1ock): 

PrintE(*BLock now freed,。 1u bytes freewn"。 arcore1eft() ): 


) /* main 終わ り */ 


プロ グラ ム 出 力 


359616 bytes free 

65000 bytes al11ocated。 294608 bytes free 

block now rea11ocated to 32500 bytes, 262100 bytes free 
Free the block 

Block now Ereed。 359616 bytes free 
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farrealloc 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


far ヒー プ に 割り 当て 済み の プロ ッ ク を 調整 し ます 。 
void far * farrealloc(void far * o/Z/oc を , unsigned long z の yzes) ・ 
alloc.h 
farealloc は , 割り 当て られ て いる プロ ッ ク の 大 き さ を z の yes に 変更 し ま 
す 。 必 要 な ら ば 内 容 の コビー も 行ない ます 。 
far ヒー プ か ら 割 り 当 て に 関し て は , 次 の 点 に 注意 し て くだ さい 。 

田 利 用 可能 な RAM は すべ て 割り 当て る こと が で きる 。 

脅 64K バイ ト を 超え る プロ ッ ク を 割り 当て る こと が で きる 。 


罰 割 り 当 て られ た ブロック を アク セス する に は far ポイ ンタ を 使用 する 。 


タイ ニ ィ モデ ル で は , プロ グラ ム を .COM ファ イル に 変換 する 場合 に は , 
farrealloc を 使う こと は で きま せん 。 


farrealloc は , 再 割 り 当 て され た プロ ッ ク の アド レス を 返し ます 。 こ れ は 
も と の プロ ッ ク の アド レス と は 異な る こと も あり ます 。 ブ ロッ ク を 再 割 り 
当て で き な か っ た 場合 , farrealloc は NULL を 返し ます 。 


farrealloc は 、 MS-DOS に 特有 の 関数 で す 。 


farmalloc,、 realloc 
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fclose 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 


例 
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スト リー ム を クロ ー ズ し ます 。 


#include <stdio.h> 
int fclose(FILE * sreg7) ・ 


stdio.h 

fclose は , 引数 syegz に 指定 され た スト リー ム を クロ ー ズ し ます 。 一 般 
に , スト リー ム に 結び つけ られ て いる すべ て の バッ ファ の 内 容 は 、 クロ ー 
ズ の 前 に フラ ッシュ され ます 。 シ ステ ム が 割り 当て た バッ ファ は クロ ー ズ 
に よっ て 解放 きれ ます 。 setbuf ある い は setybuf で 割り 当て られ た バッ フ 
ァ は 自動 的 に は 解放 きれ ませ ん 。 

fclose は , 成功 し た 場合 0 を 返し ます 。 

fclose は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 


close、 fcloseall, fdopen, fflush, flushall, freopen 


fopen を 参照 し て くだ さい 。 


第 2 章 Turbo C ラ イブ プラ リ 


fcloseall 


機能 オー プン され て いる スト リー ム を クロ ー ズ し ます 。 


形式 int fcloseall(void) : 


プロ ト タ イ プ stdioh 


解説 fcloseall は , srd 廊 、s7do47。 sf の pr2、S7 の ey、 お よび s/dgx を 除く すべ て の 
オー プン ズ ト リー ム を クロ ー ズ し ます 。 


戻り 値 fcloseall は 、 ク ロー ズ し た スト リー ム の 数 を 返し ます 。 エ ラー が あっ た 場 
合 は EOF を 返し ます 。 


可 搬性 fcloseall は UNIX シス テム て 使用 で きま す 。 


関連 項目 fclose、fdopen, flushall, fopen、freopen 
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fcvt 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 
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浮動 小数 点数 を 文字 列 に 変換 し ます 。 


#include <stdlib> 
char * fcvt(double yg/e, int 7gjg, int * dec,int 玉 52) ・ 


stdio.h 


fcvt は , vg/e の 値 を , 一 番 左 の 有効 桁 か ら 始ま り ヌ ル で 終わ る z9jg 桁 の 
文字 列 に 変換 し , その 文字 列 を 指す ポイ ンタ を 返し ます 。 小 数 点 が 文字 列 
の 先頭 か ら 何 桁 目 に ある か は , gec を 通し て 間接 的 に 格納 され ます (gec が 
負 の 場合 は 返さ れ た 最初 の 数 字 の 左 に 小数 点 が ある こと を 意味 し ます )。 
小数 点 は 文字 列 そ の も の に は 含ま れ ま せん 。 結果 の 符号 が 負 の と き は , sjg ヵ 
が 指す ワー ド は 0 で な く な り , それ 以外 の と き は 0 と な り ま す 。 

数 値 は 、 zdig に 指定 され た 桁 数 まで に 四捨五入 きれ ます 。 


fcvt の 戻り 値 は 静 的 デー タ を 指し て いる の で , fcvt が 呼ば れる た びに , そ 
の 内 容 は 上 書き され ます 。 


fcvt は UNIX シス テム て 使用 で きま す 。 


atof、 atoi, atol、 ecvt、 gcvt 
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fdopen 


機能 


形式 


プロ ト タ イ プ 


スト リー ム と ファ イル ハン ドル を 結び つけ ます 。 


#include <stdio.h> 
FILE * fdopen(int gzg/e, char * の pe) : 


stdio.h 


fdopen は 、creat, dup、dup2、open な ど に よっ て 得 ち られ た ファ イル ハン 
ドル と スト リー ム を 結び つけ ます 。 ス トリ ー ム の タイ プ は , オー プン され 
て いる 4gzde の モー ド と 一 致し な けれ ば な り ま せん 。 

fdopen で 使用 され る 文字 列 pe は , 次 の 値 の いずれ か で す 。 


読み 出し 専用 と し て オー プン する 。 

し 書き 込み 用 と し て 作成 する 。 
追加 用 。 フ ァイル の 終わ り に 書き 込む よう に オー プン する 。 
ファ イル が 存在 し な い 場 合 は 書き 込み 用 と し て 作成 する 。 

ァ 二 既存 ファ イル を 更新 (読み 出し / 書 き 込み ) 用 と し て 作成 す 


る 。 
w 十 新規 ファ イル を 更新 用 と し て 作成 する 。 
g 十 追加 朋 と し て オー プン する 。 フ ァイル の 終わ りか ら 更 新 用 と 


し て オー プン する (ファ イル が 存在 し な けれ ば 作成 する )。 


ファ イル が テキ スト モー ド で オー プン ある い は 作成 され る こと を 指定 する 
に は , ppe の 値 の 最後 に 7 を つけ ます (7 w 十 7 な ど ) 。 同 様 に 。 バイナリ 
モー ド を 指定 する に は , ppe の 値 の 最後 に か を つけ ます (w, g 十 あな 
ど )。 

7 また は ら が の pe に 指定 され て いな い 場 合 は .、 モー ド は グロ ー バ ル 変 数 
_7zzode に よっ て 決ま り ま す 。 7zoge が O_BINARY に セッ ト さ れ て い 
れ ば , ファ イル は バイ ナリ モー ド で オー プン され ます 。 妨 zoge が O 
TEXT が セッ ト さ れ て いれ ば , テキ スト モー ド で オー プン され ます 。 定数 
0 ... は , fcntlh で 定義 る 8 れ て いま す 。 
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戻り 値 


138 


ファ イル が 更新 用 に オー プン され て いる と , その スト リー ム に 対し て 入力 
と 出力 が 行 な を を な す 。 し か し , 出力 の あと で , fseek ある い は rewind を 行 
な うこ と な し に 入力 を 行なう こと は で きま せん 。 ま た 入力 の あと で , 

fseek, rewind. ファ イル の 終わ り を 検出 する 入力 の いずれ か を 行なう こと 
な し に 出力 を 行なう こと も で きま せん 。 


成功 し た 場合 , fdopen は 新た に オー プン され た スト リー ム を 返し ます 。 エ 
ラー の 場合 は NULL を 返し ます 。 


fdopen は UNIX シス テム て 使用 で きま す 。 


fclose、fopen, freopen, open 


すま 1nclude <stdio.h> 
#1nc1ude <Fcnt1.h> /* open が 使用 する モー ド の 定 寺 が 必要 */ 


matn() 

{ 
Int handlei 
FILE *streami 


/* ファ イル を オー プン */ 
hand1e = open("MYFTLE.TXT*。 O_CREAT)i 


/* スト リー ム に 結び つけ る */ 

stream = fdopen(hand1e。 "w' ) : 

1f (stream == NULL) 
Printf("fdopen fal1ed\n"): 

el1se 

{ 
fprintf(stream。 "He11o, wor1d\n* ) : 
fc1ose(stream): 

} 

) 
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機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 


スト リー ム 上 で ファ イル エン ド を 検出 し ます 。 


#include <stdio.h> 
int feof(FILE * s の eg が) : 


stdio.h 

feof は , 指定 し た seg7: に 対し て 、 フ ァイル 終了 標識 を 調べ る マク ロ で 
す 。 標識 が 一 度 セ モット され る と , rewind が 呼び 出 き れる か , その ファ イル 
が クロ ー ズ され る まで , その ファ イル に 対す る 読み 出し 操作 は ファ イル 終 
了 標 識 を 返し ます 。 

ファ イル 終了 標識 は 各 入力 操作 で リセ ッ ト さ れ ま す 。 


feof は , 指定 の スト リー ム に 対す る 最後 の 入力 操作 で , ファ イル 終了 標識 
が 検出 され た 場合 に 、0 で な い 値 を 返し ます 。 


feof は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 


clearerr、 eof, ferror、 perror 
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ferror 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 
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スト リー ム 上 の エラ ー を 検出 し ます 。 


#include <stdio.h> 
int ferror(FILE * seg7z) ・ 


stdio.h 

ferror は 、 指定 し た seg7: に 対し て , 読み 出し お よび 書き 込み エラ ー が な 
いか どう か を 調べ る マク ロ で す 。 seg に エラ ー 標 識 が 一 度 セ ッ ト さ れる 
と ,clearerr また は rewind が 呼び 出さ れる まで , ある い は その スト リー ム 
が クロ ー ズ され る まで , エラ ー 標 識 は セッ ト さ れ た まま に な り ま す 。 


ferror は , 指定 の スト リー ム 上 で エラ ー を 検出 する と 0 で な い 値 を 返し ま 
す 。 


ferror は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


clearerr, eof, feof. fopen、 gets、 perror 
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fflush 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬 性 


スト リー ム を フラ ッシュ し ます 。 


#include <stdio.h> 
int fflush(FILE * s/eg7 が ) ・ 


stdio.h 


fflush は 、 指定 さ れ た スト リー ム が 出力 用 に オー プン され て いる 場合 に 
は , seg7: の た め の バ ッ プ ファ 中 の 出力 を 結び つけ られ て いる ファ イル に 書 
き 出 し ます 。 

szeg7 が 入力 用 に オー プン され て いる 場合 に は ,、 バッ ファ の 内 容 が クリ ア 
され ます 。 

スト リー ム は , ffHush を 実行 し た 後 も オー プン され た まま で す 。fflush は 
バッ ファ リン グ き され な い ス トリ ー ム に は 何 の 影 響 も 与え ませ ん 。 


fflush は , 成功 し た 場合 0 を 返し ます 。 エ ラー が 検出 され た 場合 は EOF を 
返し ます 。 


fflush は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 


fclose、 flushall, setbuf, setvbuf 
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fgetc 
機能 スト リー ム か ら 文 字 を 得 ます 。 
形式 #include <stdio.h> 
int fgetc(FILE * seg) : 
プロ ト タ イ プ stdio.h 
解説 fgetc は , 指定 され た スト リー ム 上 の 次 の 文字 を 返し ます 。 
戻り 値 成功 し た 場合 fgetc は 読み 込ん だ 文字 を 符号 拡張 せ ず に int に 変換 し て 
返し ます 。 フ ァイル エン ド ま た は エラ ー の 場合 は EOF を 返し ます 。 
可 搬性 fgetc は UNIX シス テム て で 使用 で き , ANSI C と 互換 性 が あり ます 。 
関連 項目 fgetchar、fputc, getc, getch、 getchar、 getche, ungetc, ungetch 
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fgetchar 


機能 sz か ら 文字 を 得 ます 。 
形式 int fgetchar(void) : 
プロ ト タ イ プ stdioh 


解説 fgetchar は , srd 訪 か ら 次 の 1 文字 を 読み 込ん で 返し ます 。 
fgetchar は 、fgetc(s2) と 定義 8 れ た マク ロ で す 。 


戻り 値 成功 し た 場合 , fgetchar は 読み 込ん だ 文字 を 待 号 拡張 せ ず に int に 変換 し 
て 返し ます 。 フ ァイル エン ド ま た は エラ ー の 場合 は POF を 返し ます 。 
EOF は fgetchar が 通常 の 値 と し て 返す も の な の で , ファ イル エン ド や エ 
ラー を 検出 する た め に は , feof ある い は ferror を 使う 必要 が あり ます 。 
可 搬性 fgetchar は UNIX シス テム て 使用 で きま す 。 


関連 項目 fgetc, fputchar、 getchar 
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fgetpos 


機能 現在 の ファ イル ポイ ンタ を 得 ます 。 


形式 #include <stdio.h> 
int fgetpos(FILE * segz. fpos t 玉 pos) : 


プロ ト タ イ プ stdiojh 

解説 fgetpos は , seg に 結び つけ られ て いる ファ イル ポイ ンタ の 位置 を , pos 
が 指し て いる 場所 に 格納 し ます 。 
os 7 型 は stdio.h の 中 で , long 型 と し て typedef 宣言 され て いま す 。 


戻り 値 fgetpos は 成功 し た 場合 は 0 を 返し , 失敗 し た 場合 は 0 以外 の 値 を 返し ます 。 


関連 項目 fseek, fsetpos、 ftell、tell 
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fgets 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


スト リー ム か ら 文 字 列 を 得る 


#include <stdio.h> 
char * fgets(char * 5,int FILE * seg70) ・ 


stdio.h 


fgets は , seg か ら 文 字 の 並び を 読み , 文字 列 ゞ に 格納 し ます 。 読み 込み 
は , ( ヵ ー1) 個 の 文字 を 読み 込む か , 改行 文字 を 読み 込ん だ 段階 で 終わ り ま 
す 。 fgets は , 改行 文字 は 文字 列 に 含め ませ ん 。 ゞ に 読み 込ま れ た 最後 の 文 
字 の 後に は ヌル 文字 が つき ます 。 


fgets は ゞ が 指し て いる 文字 列 を 返し ます 。 フ ァイル エン ド あ る い は エラ 
ー の 場合 は NULL を 返し ます 。 


fgets は UNIX シス テム て で 使用 で き , ANSIC と 互換 性 が あり ます 。 K&R 
で も 定義 き 8 れ て いま す 。 


cgets、 fputs、 gets 
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filelength 


プロ ト タ イ プ 


戻り 値 


関連 項目 


146 


ファ イル の 長 さ を バイ ト 単 位 で 得 ます 。 


#include <io.h> 
1ong filelength(int が gzge) : 


jo.h 


filelength は 、 ん gzgde に 結び つけ られ て いる ファ イル の 長 さ を バイ ト 単 位 
で 返し ます 。 


成功 し た 場合 、filelength は ファ イル の 長 さ を long 型 で 返し ます 。 エラ ー 
の 場合 は -1 を 返し 、 eryzo に 次 の 値 を セッ ト し ます 。 


EBADF ファ イル 番号 が 正しく な い 


fopen, lseek、 open 
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fileno 


機能 ファ イル ハン ドル を 得る 


形式 #include <stdio.h> 
int fileno(FILE * s/eg7) ・ 


プロ ト タ イ プ stdioh 


解説 fileno は , 引数 syegn の ファ イル ハン ドル を 返す マク ロ で す 。 seg/7 が 複 
数 の ハン ドル を 持つ 場合 、 filemo は その スト リー ム が 最初 に オー プン され 
た と き に 割り 当て られ た ハン ドル を 返し ます 。 


戻り 値 s の eg が に 結び つけ られ た ファ イル ハン ドル を 表わす 整数 値 を 返し ます 。 
可 搬性 fileno は UNIX シス テム で 使用 で きま す 。 
関連 項目 fdopen, fopen、freopen 
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findfirst 


機能 


形式 


プロ ト タ イ プ ブ 


解説 
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ディ スク ディ レク トリ を 探索 する 。 


#include <dir.h> 
#include <dos.h> 
int findfirst (const char *※ /g7 が gie, Struct ffblk * の 災 ,int 7 の め ) : 


dir.h 


findfirst は 、DOS の シレ ステ ムコ ー ル 0Ox4E を 使っ て , ディ スク ディ レク ト 
リ の 探索 を 開始 し ます 。 
p27 が gie は 。 探索 する ファ イル 名 の 前 に オプ ショ ン の ドラ イブ 名 , パス 名 
が つい た も の で す 。 フ ァイル 名 の 部 分 に は , ワイ ルド カー ド ? *※) を 含 
め る こと が で きま す 。 一 致す る ファ イル が 見 つか っ た 場合 は , ffblk 構造 体 
に は ファ イル ディ レク トリ 情報 が し まわ れ ま す 。 
ffblk 構造 体 は 大 の よう に 定義 され て いま す 。 
struct EEblk ( 

char ff reserved[21]: /* MS-DOS で 予約 */ 

char ff attrlbi /* アト リ ビ ュ ー ト */ 
/* ファ イル の 時 諸 */ 
/* ファ イル の 日 付 */ 
5 /* ファ イル サイ ズ +/ 


char EE _name[13]i /* ファ イル 名 。 */ 
} 


g7 み め は MS-DOS の ファ イル 属性 バイ ト で あり , 探索 に 際 し て , 選択 の 基 
準 と な る も の で す 。g/ め は dos.h の 中 で 定義 きれ て いる 次 の 定数 の い ず 
れ か と な り ま す 。 


FA_RDONLY 読み 出し 専用 
FA HIDDEN 不可 視 フ ァイル 
FA _ SYSTEM シス テム ファ イル 


FA LABEL ポリ ュー ムラ ベル 
FA DIREC ディ レク トリ 
FA_ARCH アー カイ プ 
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これ ら の 属性 に つい て の 詳細 は , MS-DOS プロ グラ マー ズリ ファ レン スマ 
ニュ アル を 参照 し て くだ さい 。 

findfirst は DOS の ディ スク トラ ンス ファ アド レス (DTA) に , ffblk の 
アド レス を セッ ト す る こと に 注意 し て くだ さい 。 

DTA の 値 を 必要 と する 場合 は , fimdfirst の 各 呼 び 出し の 後 で , (getdta と 
setdta を 使っ て ) DTA を セー ブ し て 元 に 戻す 必要 が あり ます 。 


戻り 値 pg7zgzie に 一 致す る ファ イル が 見 つか っ た 場合 , findfirst は 0 を 返し ま 
す 。 一 致す る ファ イル が 見 つか ら な いり 場合 や 、 ファ イル 名 に 誤 リ が ある 場 
合 は -1 を 返し , eryzzo に 次 の いずれ か の 値 を セッ ト し ます 。 


ENOENT バス 名 や ファ イル 名 が 見 つか ら な い 
ENMFILE も う フ ァイル が な い 


可 搬性 findfirst は MS-DOS に 特有 の も の で す 。 


関連 項目 findnext 


例 旭 nc1ude <stdio.h> 
nclude <dlr.h> 


main() 
( 
struct EEb1ik EEb1ki 
1nt donei 
Printf("Directory 1isting of *.*n")s 
done = flndflret("*.*"。 &EEbLk。 0)j 
while (!done) 
{ 
Printf(" Zswn"。 ffb1k.ff_name)s 
done = findnext(&ffb1k) 
} 
} 


プロ グラ ム 出 力 


Directory 1isting Of *.* 
FTNDPRST.C 
FTNDFRST.0BJ 
FTNDFRST.MAP 
FTNDFRST.EXE 
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findnext 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 


例 
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findfirst で の 探索 を 続け ます 。 


#include <dir.h> 
int findnext(struct ffblk * 7 の 広 ) : 


dir.h 


fimdnext は 、findfirst で 指定 し た pg が zg7e に 一 致す る 次 の ファ イル を 
探す た め に 使用 し ます 。 ガ が は , fimdfirst の 呼び 出し で 情報 が 格納 され た 
プロ ッ ク と 同じ も の で す 。 こ の ブロック に は 。 探索 を 続け る た め に 必要 な 
情報 が 含ま れ て いま す 。findnext は 、pg/ が ag7e に 一 致す る ファ イル が 対象 
の ディ レク トリ の 中 で 見 つか ら な く な る まで , 1 回 の 呼び 出し ご と に 1 つ ず 
つ フ ァイル 名 を 返し ます 。 

findnext は 、MS-DOS の ディ スク トラ ンス ファ アド レス (DTA) に , ffblk 
の アド レス を セッ ト す る こと に 注意 し て くだ さい 。 

DTA の 値 を 必要 と する 場合 は 、 findnext の 各 呼 び 出し の 後 で , (getdta と 
setdta を 使っ て ) DTA を セー プア し て 元 に 戻す 必要 が ありま す 。 


pg が gie に 一 致す る ファ イル が 見 つか っ た 場合 , fimndnext は 0 を 返し ま 
す 。 も う 一 致す る ファ イル が 見 つか ら な い 場 合 や 、 フ ァイル 名 に 誤り が あ 
る 場合 は -1 を 返し 、 er7zzo に 次 の いずれ か の 値 を セッ ト し ます 。 


ENOENT バス 名 や ファ イル 名 が 見 つか ら な い 
ENMEFILE も う フ ァイル が な い 


fimdnext は MS-DOS に 特有 の 関数 で す 。 


findfirst 


findfirst を 参照 し て くだ さい 。 
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floor 


機能 小数 点 以下 の 切り 捨て を 行ない ます 。 


形式 #include <math.h> 
double floor(double *) : 


プロ ト タ イ プ mathh 


解説 floor は , * を 越え な い 最 大 の 整数 を 返し ます 。 
戻り 値 floor は 、 見 つか っ た 整数 を double て 返し ます 。 
可 搬性 floor は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


関連 項目 ceil fmod 
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flushall 


機能 すべ て の パッ ファ を フラ ッシュ し ます 。 

形式 int flushall(void) : 

プロ ト タ イ ト stdioh 

解説 flushall は ,。 オー プン され て いる 入力 スト リー ム に 結合 し て いる すべ て の 
バッ ファ の すべ て を クリ ア し , 出力 スト リー ム に 結び つけ られ て いる すべ 
て の バッ ファ の 内 容 を 対応 する ファ イル に 書き 出し ます 。flushall の 後 で 
読み 込み を 行なう と , 入力 ファ イル か ら バ ッ フ ァ に デー タ を 新た に 読み 込 
せこ と に な り ま す 。 


fiushall の 実行 後 も 、 スト リー ム は オー プン され た まま で す 。 


戻り 値 flushall は 、 オー プン され て いる 入力 お よび 出力 スト リー ム の 数 を 返し ま 
す 。 エ ラー が あっ た 場合 は EOF を 返し ます 。 


可 搬 性 flushall は UNIX シス テム で 使用 で きま す 。 


関連 項目 fclose、fcloseall、fflush 
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fmod 


機能 * を 了 て 割っ た 剰余 を 計算 し ます 。 


形式 #include <math.h> 
double fmod(double *, double ) : 


プロ ト タ イ プ mathh 


解説 fmod は , * を 了 て 割っ た 余り (x= ニ ル + 了 お よび 0= ヅ バツ を 満た す 。 7 は 
整数 ) を 計算 し ます 。 


戻り 値 fmod は , 剰余 / (* ニ ルオ ア ) を 返し ます 。 


可 搬性 fmod は ANSI C と 互換 性 が あり ます 。 


関連 項目 ciel floor、modf 
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fnmerge 


機能 ファ イル 名 を 作り ます 。 


形式 #include <dir.h> 
void fnmerge(char * pg が , const char *※ drive, const char * dir, 
const char *※ 7ie, COnSt char ※ eX7) ・ 


プロ ト タ イ プ dirh 


解説 fnmerge は 、 要素 を 組み 合わ せ て バス 名 を 作り 出し ます 。 新しい パス 名 は 
次 の 形式 に な り ま す 。 


X : \DIR\SUBDIR\NAME.EXT 


この ファ イル 名 は 次 の よう に し て 構成 され ます 。 


一 X は , の pe に よっ て 与え られ る 
田 \DIR\SUBDIR は 、 2 に よっ て 与え られ る 
回 NAME.EXT は 、 ze と ex7 に よっ て 与え られ る 


fnmerge は , pg に は 構成 され た バス 名 を 格納 する の に 充分 な 領域 が あ 
る も の と みな し ます 。 構成 され る バス 名 の 最大 長 は MAXPATH で す 。 
MAXPATH は dir.h で 定義 S8 れ て いま す 。 

fnmerge と fnsplit は 、 ち ょ うど 逆 の 操作 を 行ない ます 。 つま り , ある パス 
名 を fnsplit て 分 解 し て , fnmerge で 各 要 素 か ら バ パス 名 を 組み 立て る と 、 元 


の バス が 復元 され ます 。 
戻り 値 あり ませ ん 。 
可 搬性 fnmerge は MS-DOS で の み 使 用 で きま す 。 


関連 項目 fnsplit 
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例 1nc1ude <stdio.h> 
nc1ude <dir.h> 


char drive[MAXDRTVE]: 
char dir[MAXDTR]: 
char fi1e[MAVFTLE]: 
char ext[MAXEXT] : 


main() 

( 
char s[MAXPATH] , て [MAXPATH]: 
1nt f1agi 


for ( 
( 
printf("> ): /* さら に 入力 が ある か ぎり */ 
if (!gets(s)) breaki /* 入力 の プロ ンプ ト を 表示 */ 
if (lgets[0]) breaki 
fl1ag = fnsp1it(s,drive,dir,E11e。ext ) : 


) 


/* 要素 を 表示 */ 
Printf(" drivei Zs, diri Z8。 人 11ei Z8。 exti 28。 " 
drive,。 dir。 fi1e,。 ext): 

printE("E1agei ") ぉ 

1f (El1ag & DRTVE) 
PrintE("E" う 5 

1f (fl1ag & DIRECTORY) 
printE("d"): 

1f (flag & FILENAME) 
PrintE("E"): 

1f (Elag & EXTENTTON) 
printf("e")s 

Printf("\n*): 


/* 各 要 素 を 再 構 成 し て 元 の 文字 列 と 比較 */ 
fnmerge(t,drive。d1r,f11e,ext): 


1 (strcmp(t.s) != 0) /* 起こ る は ず は な い +4/ 
Printf(* --> strings are differenti*): 


プロ グラ ム 出 力 


> C:\TURBOCWFN.C 


drive: ,。 dir: ,。 file: FILE。 ext: .C。flags: fe 
> TURBOCSUBDTR INOEXT . 

drive: , dir: TURBOCSUBDTR ぜ 。 fi1e: NOEXT。 

exti .。 Elagsi dfe 
> CiMYEILE 

drive: Ci。 diri 。 Ele:MYFILE。 ext: 。Elags :f 
> へ 2 
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機能 


形式 


プロ ト タ イ プ 
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フル バス 名 を 要素 に 分 割 し ます 。 


#include <dir.h> 
int fnsplit(const char * pg char * の ve, char * の か , 
char * ge Char ※ eX7) : 


dir.h 


fnsplit は 。 次 の 形式 の 文字 列 が 表わす ファ イル の フル バス 名 (pg 放 ) を , 
4 つの 要素 に 分 割 し ます 。 


X : \DIR\SUBDIR\NAME.EXT 


各 要 素 は それ ぞ れ み pe、 zzze。 ex が 指す 文字 列 に 格納 され ます (5 
つの 引数 すべ て を 渡 き な けれ ば な り ま せん 。 要 素 に は NULL を 指定 する 
こと が で きま す が , その 場合 , その 要 朱 の 解析 が 行なわ れる だ け で どこ に 
も 格納 され ませ ん )。 

これ ら 文 字 列 の 最大 長 は 、 定数 MAXDRIVE, MAXDIR、 MAXPATH, 
MAXNAM (dirh の 中 で 定義 され て いま す ) で 与え られ ます 。 こ れ ら の 中 
に は ヌル 文字 の スペ ー ス も 含ま れ ま す 。 


ーーーーーーーーーーーーーーーーーーーーーーーーーー 
定数 (最大 長 ) 文字 列 


MAXPATH (80) の 2 

MAXDRIVE ( 3 の ze : コロ ン (:) も 含む 

MAXDIR (66) 必 : 先頭 と 最後 の 円 記号 ( 壮 ) も 含む 
MAXFILE ( 9) 776 

MAXNET (5) @7 : 先頭 の ビリ オド (.) も 含む 
ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 
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fnsplit は , NULL で な い 要 素 を 格納 する た め の 充分 な 大 きき さ の スペ ー ス 
が ある こと を 仮定 し て いま す 。 
fnsplit が pg を 分 割 す る と き に は , 次 の 規則 が 適用 きれ ます 。 


一 の ie に は , コロ ン が 含ま れる (C:、A: な ど ) 

田 2 に は , 先頭 と 最後 の 円 記号 も 含ま れる ( ぎ turbo\include, 
半 source\ な ど ) 

一 226 に は 、 ファ イル 名 が 含ま れる 

回 exi に は , 拡張 子 の 前 の ビリ オド が 含ま れる 


fnsplit と fnmerge は ちょ うど 逆 の 操作 を 行ない ます 。 あ る 7/g 太 を 
fnsplit で 分 割 し て , 分 割 し た 各 要 素 を fmmerge で 組み 立て る と , 元 の 
pg 太 が で き あ が り ま す 。 


戻り 値 fnsplit は ,、 フル バス 名 の どの 要素 が pg7, の 中 に 含ま れ て いる か を 表わす 
(dir.h で 定義 され て いる 5 個 の フラ グ か ら な る ) 整 数 を 返し ます 。 各 フラ グ 
と 対応 する 要素 は 次 の よう に な っ て いま す 。 


EXTENSION 拡張 子 
FILENAME ファ イル 名 
DIRECTORY ディ レク トリ (お よび サ プ デ ィ レ クト リ ) 
DRIVE ドラ イブ 指定 (dir.h を 参照) 
WILDCARD ワイ ルド カー ド (* ま た は ?) 

可 搬性 fnsplit は MS_DOS シス テム で の み 使 用 可能 で す 。 


関連 項目 fnmerge 


例 fnmerge を 参照 し て くだ さい 。 
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fopen 


機能 


形式 


プロ ト タ イ プ 


158 


スト リー ム を オー プン する 。 


#include <stdio.h> 


FILE * fopen(const char * ezg7e, const char ※ joge) : 


stdio.h 


fopen は ezgzze で 指定 され た ファ イル を オー プン し , スト リー ム と 結び 
つけ ます 。fopen は 以後 の 操作 で その スト リー ム を 識別 する の に 使用 され 
る ポイ ンタ を 返し ます 。 

fopen で 使用 され る 文字 列 odg は 次 の 値 の いずれ か で す 。 


ヶ 読み 出し 専用 と し て オー プン する 。 

し 書き 込み 用 と し て 作成 する 。 
追加 用 。 フ ァイル の 終わ り に 書き 込む よう に オー プン する 。 
ファ イル が 存在 し な い 場 合 は 書き 込み 用 と し て 作成 する 。 


ヶ 土 既存 ファ イル を 更新 (読み 出し / 書 き 込 み ) 用 と し て 作成 す 
る 。 

十 新規 ファ イル を 更新 用 と し て 作成 する 。 

g 十 追加 用 と し て オー プン する 。 フ ァイル の 終わ りか ら 更 新 用 と 


し て オー プン する (ファ イル が 存在 し な けれ ば 作成 する )。 


ファ イル が テキ スト モー ド で オー プン ある い は 作成 され る こと を 指定 する 
に は , iode の 値 の 最後 に 7 を つけ ます (7 w 十 7 な ど )。 同様 に 。 バイ ナ 
リモ ー ド を 指定 する に は 、 zzoge の 値 の 最後 に のり を つけ ます (wb, g 十 りな 
ど )。fopen で は , 文字 7 また は め を , oge 文字 列 中 の 文字 と の 間 に 入 
れ て も か まい ませ ん 。 た と えば , 7 十 は 7 十 7 と 同じ 意味 を も ち ま す 。 

7 また は ち が gde に 指定 され て いな いり 場合 は , モー ド は グロ ー バ ル 変 数 
_7 が zoge に よっ て 決ま り ま す 。 zoge が O_BINARY に セッ ト さ れ て い 
れ ば , ファ イル は バイ ナリ モー ド で オー プン され ます 。 zoge に 
O_TEXT が セッ ト さ れ て いれ ば , テキ スト モー ド で オー プン され ます 。 定 
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戻り 値 


可 搬 性 


関連 項目 


例 


数 O ..…. は , fcntlh で 定義 る され ます 。 
ファ イル が 更新 用 に オー プン され て いる と , その スト リー ム に 対し て 入力 
と 出力 が 行 を な を を な す 。 し か し , 出力 の あと で , fseek ある い は rewind を 行 
な うこ と な し に 入力 を 行なう こと は で きま せん 。 ま た 入力 の あと で , 

fseek、 rewind. ファ イル の 終わ り を 検出 する 入力 の いずれ か を 行なう こと 
な し に 出力 を 行なう こと も で きま せん 。 


成功 し た 場合 、fopen は 新た に オー プン され た スト リー ム へ の ポイ ンタ を 
返し ます 。 エ ラー の 場合 は NULL を 返し ます 。 


fopen は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。K& 
R で も 定義 &8 れ て いま す 。 


creat, dup、fclose、fdopen、ferror、 77zode( 変 数 )、fopen, 


fread, freopen、 fseek、 fwrite、 open、rewind、 setbuf, setmode 


/* AUTOEXEC.BAT ファ イル の バッ クア ッ プ を 作成 する プロ グラ ム */ 


#1nclude <stdio.h> 


main() 


( 


FILE *in,。 *outi 


1f ((n = fopen("wwAUTOEXEC.BAT" 。 "rt") ) == NULL) 
い 
fprint(stderr。 "Cannot open 1nput f11e.\Wn*'): 
return (1): 


) 


1f ((out = fopen("AUTOEXEC.BAK" , "wt* ) ) == NOLL) 
( 
fprint(stderr, "Cannot open output fi1e.\n"): 
return (1): 
} 


while (!feof(in)) 
fputc(Egetc(in), out)i 


fc1ose(in)s 
fc1ose(out)i 
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機能 far アド レス の オフ セッ ト 値 を 得 ます 。 


形式 #include <dos.h> 
unsigned FP OFF (7Zzpoizfe/) : 


プロ ト タ イ プ dosh 


解説 FP_OFF マク ロ は 、 far ポイ ンタ ao 六 fer の オフ セッ ト 値 を 得る た め に 
使用 され ます 。 

戻り 値 FP OFF は , オフ セッ ト 値 を 表わす 符号 な し 整数 値 を 返 し ます 。 

関連 項目 FP SEG, MIK FP、movedata, segread 

例 #1nclude <stdio.h> 


#1nclude <dos.h> 


main () 

( 
Char far *Dtri 
unsigned seg, offi 


ptr = MK FP(OxB000,0): 
seg = FP_SEG(ptr)i 
oEE = PP_OPF(ptr): 


PFIntE("far ptr PD。 segment Z04x offset 04xwn',ptr,seg,OF): 
} 


プロ グラ ム 出 力 


far ptr BO00:0000, segment b000, oEfset 0000 
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_fpreset 


機能 浮動 小数 点数 学 パ ッ ケ ー ジ を 再 初 期 化 し ます 。 
形式 void fpreset(void) ・ 
プロ ト タ イ プ floath 


解説 _fpreset は 浮動 小数 点数 学 バ パッ ケー ジ の 再 初期 化 を 行ない ます 。 こ の 関 
数 は 通常 、system、 exec.…, spawn.… 関 数 と と も に 使用 され ます 。 


注意 : MS-DOS の バー ジョ ン 2.x* や 3.x より 前 の バー ジョ ン の 下 で , プロ 
グラ ム 中 で 8087/80287 コ プロ セッ サ が 使用 きれ て いる 場合 、 (system, 
exec.…, SDawn.… 関 数 で 実行 し た ) 子 プロ セス は , 親 プ ロ セ ス の 浮動 小数 点 
状態 を 変更 する 場合 が あり ます 。 


8087/80287 を 使う 場合 は 大 の よう な 点 に 注意 し て くだ さい 。 
玉 浮 動 小数 点 の 式 を 評価 し て いる 間 は , system, exec.… spawn.… 関 数 
は 呼び 出さ な い 。 
田子 プロ モス が 8087/80287 で 浮動 小数 点 操作 を 行なっ た 可能 性 が ある 場 
合 は , system, exec.…, spawn.… 関 数 の 後 で fpreset を 呼ん で , 浮動 
小数 点 状態 を リセ ッ ト す べき で ある 。 
戻り 値 戻り 値 は あり ませ ん 。 


関連 項目 _clear87、 control87, exec.… spawn.… status87、system 
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fprintf 


機能 スト リー ム に 書式 つき 出力 を 行ない ます 。 


形式 #include <stidio.h> 
int fprintf(FILE * segz, const char * oyzzg7 [argument,…]) : 


プロ ト タ イ プ stdioh 


解説 fprintf は 、/orzzg7 に よっ て 指 さ れ る 書式 文字 列 中 の 書式 指定 を 、 ozg7 
の 後に 続く 各 引 数 に 適用 し 、 書 式 化 さ れ た デー タ を 指定 され た スト リー ム 
に 出力 し ます 。 書 式 指定 の 数 は , 後に 続く 引数 と 同じ だ け な け れ ば な り ま 
せん 。 
書式 指定 に 関す る 詳細 な 情報 に つい て は , printf の 解説 を 参照 し て くだ さ 


い 。 


戻り 値 fprintf は 、 出 力 し た バイ ト 数 を 返し ます 。 エ ラー の 場合 に は EOF を 返し 
ます 。 
可 搬性 fprintf は UNIX シス テム て 使用 で き , ANSIC と 互換 性 が あり ます 。 K& 


R で も 定義 され て いま す 。 


関連 項目 cprintf, fscanf, printf, putc, sprintf 


例 printf を 参照 し て くだ さい 。 
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FP SEG 


機能 far アド レス の セグ メン ト 値 を 得 ます 。 


形式 #include <dos.h> 
unsigned FP SEG(/27 の 7 が 7e/) ・ 


プロ ト タ イ プ dosh 


解説 FP_SEG マク ロ は , far ポイ ンタ ypofer の セグ メン ト 値 を 得る た め に 
使用 され ます 。 
戻り 値 FP_SEG は 、 セグメント 値 を 表わす 符号 な し 整数 値 を 返し ます 。 


関連 項目 FP OFF、MKFP 


例 FP_OFF を 参照 し て くだ さい 。 
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fputc 


機能 スト リー ム へ 1 文字 を 出力 し ます 。 


形式 #include <stdio.h> 
int fputc(Gint c, FILE * segz) : 


プロ ト タ イ プ stdioh 


解説 fputc は , 文字 c を 指定 し た スト リー ム sreg7z へ 出力 し ます 。 

戻り 値 成功 し た 場合 fpute は 文字 c を 返し ます 。 エラ ー の 場合 は EOF を 返し ま 
す 。 

可 搬性 fputc は UNIX シス テム て で 使用 で き , ANSI C と 互換 性 が あり ます 。 


関連 項目 fgetc、 putc 
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fputchar 


機能 sdozz へ 1 文字 出力 し ます 。 


形式 #include <stdio.h> 
int fputchar(int c) : 


プロ ト タ イ プ stdiojh 


解説 fputchar は , 文字 c を soz7 に 出力 し ます 。 
fputchar(c) は 、fputc(c,sZog7) と 同じ で す 。 


戻り 値 成功 し た 場合 , fputchar は 文字 c を 返し ます 。 エ ラー の 場合 は EOF を 返 
し ます 。 

可 搬性 fputchar は UNIX シス テム て 使用 で きま す 。 

関連 項目 fgetchar,、 putchar 
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プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 
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スト リー ム に 文字 列 を 出力 し ます 。 


#include <stdio.h> 
int fputs(const char * $, FILE * se が ) ・ 


stdio.h 
fputs は , ヌル 文字 で 終わ る 文字 列 ゞ を , 指定 の 出力 スト リー ム seg へ 
コピ ー し ます 。 改行 文字 は つけ ず , また 最後 の ヌル 文字 は コピ ー さ れ ま せ 


ん 。 


fputs は , 成功 し た 場合 は 最後 に 書い た 文字 を 返し 、 エラ ー の 場合 は EOF 
を 返し ます 。 


fputs は UNIX シス テム て 使用 で き 、 ANSIC と 互換 性 が あり ます 。 K&R 
で も 定義 きれ て いま す 。 


fgets、 gets、 puts 
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プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 


スト リー ム か ら デ ー タ を 読み 込み ます 。 


#include <stdio.h> 
size t fread(void * p/, size t sze, size t 7 ヵ , FILE * se が) ・ 


stdio.h 


fread は ヵ 個 の デー タ ( 各 デ ー タ は sze バイ ト の 大 き さ ) を 指定 の 入力 ス 
トリ ー ム か ら 読 み 込ん で , pr が 指す ブロ ッ ク に 格納 し ます 。 
読み 込ま れる バイ ト 数 の 合計 は (zXsze) と な り ま す 。 

py は , どん な オプ ジェ クト で も 指す こと が で きる よう に 宣言 され て いま 
す 。 


成功 し た 場合 , fread は 実際 に 読み 込ん だ デー タ の 個数 を 返し ます (バイ ト 
数 で は あり ませ ん )。 ファ イル エン ド ま た は エラ ー の 場合 に は , デー タ 数 よ 


り 小さ な 値 (0 の こと も あり ます ) を 返し ます 。 


fread は すべ て UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ま 
す 。 


fopen、 fwrite、 printf、 read 
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機能 割り 当て 済み の ブロ ッ ク を 解放 し ます 。 

形式 void free(void * が ocx) : 

プロ ト タ イ プ stdlib.h, alloc.h 

解説 free は , calloc, malloc, realloc の 呼び 出し て 以前 に 確保 ミ れ た プロ ッ ク 


を 解放 し ます 。 ock に は 、 その メモ リプ ブロック の 先頭 バイ ト の アド レス が 
入っ て いな けれ ば な り ませ ん 。 


戻り 値 戻り 値 は あり ませ ん 。 
可 搬性 free は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 
関連 項目 calloc、freemem、 malloc、realloc, strdup 
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freemem 


機能 割り 当て 済み の DOS メモ リプ ロッ ク を 解放 し ます 。 


形式 int freemem (unsigned segx) : 


プロ ト タ イ プ dosh 


解説 freemem は 、 以前 の allocmem の 呼び 出し て 確保 さ ミ れ た メモ リプ ロッ ク を 
解放 し ます 。segx に は , その プロ ッ ク の セグ メン ト ア ドレ ス を 指定 し ま 
に 

戻り 値 freemem は 、 成功 し た 場合 に は 0 を 返し ます 。 エ ラー の 場合 に は -1 を 返し , 


er7zzO に ENOMEM (メモ リ が 不足 し た ) を セ モット し ます 。 


関連 項目 allocmem、free 
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freopen 


機能 スト リー ム を 置き 換え ます 。 


形式 #include <stdio.h> 
FILE * freopen (const char * /ZMezgzze, Const Char 玉 7 の de, 
FILE * seg77) : 


プロ ト タ イ プ stdioh 


解説 freopen は 、 オ ー プ ンス トリ ー ム seg を , 指定 の ファ イル に 置き か えま 
す 。 seg が が は 、 そ の オー プン が 成功 し た か どう か に 関係 な 4 クロ ー ズ され 
ます 。 
freopen は 、s/g 訪 。s4dof、s7derr に 結び つけ られ て いる ファ イル を 変更 す 
る の に 便利 で す 。 
freopen の 呼び 出し で 使用 され る 文字 列 ode は , 次 の 値 の いずれ か で す 。 


/ 読み 出し 専用 と し て オー プン する 。 

w 書き 込み 用 と し て 作成 する 。 
追加 用 。 フ ァイル の 終わ り に 書き 込む よう に オー プン する 。 
ファ イル が 存在 し な い 場 合 は 書き 込み 用 と し て 作成 する 。 


ヶ 寺 既存 ファ イル を 更新 (読み 出し / 書 き 込 み ) 用 と し て 作成 す 
る 。 

w 十 新規 ファ イル を 更新 用 と し て 作成 する 。 

2 十 追 胃 と し て オー プン する 。 フ ァイル の 終わ りか ら 更 新 用 と 


し て オー プン する (ファ イル が 存在 し な けれ ば 作成 する )。 


指定 ファ イル が テキ スト モー ド で オー プン ある い は 作成 され る こと を 指定 
する に は , oge の 値 の 最後 に 7 を つけ ます (7 w 十 7 な ど )。 同様 に ,。 バ 
イナ リモ ー ド を 指定 する に は , oge の 値 の 最後 に り を つけ ます (wp g 二 
な ど )。 

7 また は らち が zzoge に 指定 され て いな い 場 合 は , モー ド は グロ ー バ ル 変 数 
_ 妨 zode に よっ て 決ま り ま す 。 7zoge が O_BINARY に セッ ト さ れ て い 
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れ ば , ファ イル は バイ ナリ モー ド で オー プン され ます 。 が 7zoge が 0 
TEXT が セッ ト さ る され て いれ ば , テキ スト モー ド で オー プン され ます 。 定数 
0 .. は , fcntl.h で 定義 る され ます 。 

ファ イル が 更新 用 に オー プン され て いる と , その スト リー ム に 対し て 入力 
と 出力 が 行 を を な す 。 し か し , 出力 の あと で , fseek ある い は rewind を 行 
な うこ と な し に 入力 を 行なう こと は で きま せん 。 ま た 入力 の あと で , 
fseek, rewind.、 フ ァイル の 終わ り を 検出 する 入力 の いずれ か を 行なう こと 
な し に 出力 を 行なう こと も で きま せん 。 


戻り 値 成功 し た 場合 , freopen は 引数 sregzz を 返し ます 。 エ ラー の 場合 は NULL 
を 返し ます 。 

可 搬性 freopen は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 

関連 項目 fclose、 fdopen、fopen、open, setmode 

例 fopen を 参照 し て くだ さい 。 
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frexp 


機能 double の 変数 を 仮数 部 と 指数 部 に 分 割 し ます 。 


形式 #include <math.h> 
double frexp(double *, int * expoe7/) : 


プロ ト タ イ プ mathh 

解説 frexp は 、 引数 * (も と の double 値 ) か ら 、x = X27 と な る よう な 仮数 
(0.5 以 上 1 未満 の double) と 整数 値 ヵ を 計算 し ます 。frexp は , expoe77 
が 指す 整数 に ヵ の 値 を 格納 し ます 。 


戻り 値 frexp は 仮数 久 を 返し ます 。 
frexp の エラ ー 処 理 は 、matherr 関数 を 使っ て 変更 する こと が で きま す 。 


可 搬性 frexp は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 


関連 項目 exp, ldexp 
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fscanf 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


スト リー ム か ら 書 式 つ き 入 力 を 行ない ます 。 


#include <stdio.h> 
int fscanf(FILE * sreg, const char * /o7zg7 [gg の ess,…] ) : 


stdio.h 


fscanf は 一 連 の 入力 フィ ー ル ド を スキ ャ ン し て , 一 度 に 1 文字 ずつ スト リ 
ー ム か ら 文 字 を 読み 込み ます 。 次 に , 引数 zzg7 に よっ て 指 さ れ る 書式 文 
字 列 中 の 書式 指定 に し た が っ て , 各 フ ィ ー ル ド を 書式 化し ます 。 最 後に , 
76rzzg7 の 後に 続く 各 引 数 が 示し て いる アド レス に , 書式 化し た 入力 を 格納 
し て いき ます 。 書 式 文字 列 中 の 書式 指定 の 個数 は 、 その 後に 続く アド レス 
の 数 と 同じ で な けれ ば な り ませ ん 。 

書式 指定 も 含め て , 詳細 な 情報 に つい て は scanf の 解説 を 参照 し て くだ さ 
い 。 

fscanf は 、 通 常 の フィ ー ル ド の 終了 (ホワ イト スペ ー ス ) に 達する 前 に , 
フィ ー ル ド の スキ ャ ン を や め る 場合 が あり ます 。 ま た , いく つか の 理由 か 
ら 入 力 を 終了 し て し まう こと も あり ます 。 こ うし た 問題 に つい て は scanf 
の 解説 を 参照 し て くだ さい 。 


fscanf は 、 正 し く ス キャ ン し , 変換 し , 格納 し た 入力 フィ ー ル ド の 数 を 返 
し ます 。 戻 り 値 に は 、 値 を 格納 し な か っ た 入力 フィ ー ル ド の 数 は 含ま れ ま 
せん 。 

ファ イル エン ド を 読み 込 も う と し た 場合 は , 戻り 値 は EOF に な り ま す 。 値 
を 格納 し た フィ ー ル ド が な か っ た 場合 は , 戻り 値 は 0 に な り ま す 。 


fscanf は UNIX シス テム で 使用 で き , K&R で 定義 きれ て いま す 。ANSI 
C と も 互換 性 が あり ます 。 


atof, cscanf, fprintf、 printf, scanf、 sscanf, vfscanf、 


Yscanf, vsscanf 
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fseek 


機能 


形式 


プロ ト タ イ プ 


戻り 値 
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スト リー ム 上 の ファ イル ポイ ンタ を 移動 し ます 。 


#include <stdio.h> 
int fseek (FILE * s/eg, long int の 775er, int wezce) : 


stdio.h 


fseek は , seg7z に 結び つけ られ て いる ファ イル ポイ ンタ を , wezce で 指 
定 さ れ た ファ イル の 位置 か ら , ge バイ ト 離れ た と ころ に 位置 づけ ます 。 
テキ スト モー ド の スト リー ム で は , oser は 0 か , ftell に よっ て 返さ れ た 値 
で な けれ ば な り ま せん 。 

wezce は 、0,1、2 の いずれ か で な けれ ば な り ま せん 。 こ の 3 つの 定数 は 次 
の よう な シン ポリ ッ ク 定 数 で 表 さ れ ま す (stdio.h の 中 で 定義 され て いま 
す )。 


wezce 位置 


SEEK SET (0) ファ イル の 初め 
SEEK CUR (1) 現在 の ファ イル ポイ ンタ の 位置 
SEEK END (2) ファ イル の 終わ り 


fseek は , ungetc が プッ シュ バッ ク し た 文字 は 捨て 去り ます 。 

fseek は , スト リー ム 1/O に 対し て 使用 し ます 。 フ ァイル ハン ドル 1/0 に 
は lseek を 使っ て くだ さい 。 

更新 用 に オー プン され た ファ イル に 対し て は , fseek を 呼び 出し た 後 は , 入 
力 ・ 出 力 ど ちら で も 行なう こと が で きま す 。 


成功 し た 場合 , fseek は 0 を 返し ,、 エラ ー の 場合 は 0 で な い 値 を 返し ます 。 
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可 搬性 fseek は すべ て の UNIX シス テム で 使用 で き 、 ANSIC と 互換 性 が あり ま 


す 。 
関連 項目 fgetpos、 fopen、 fsetpos, ftell、lseek、 rewind、 setbuf, tell 
例 1nc1ude <stdio.h> 


/* ファ イル スト リー ム 内 の バイ ト 数 を 返す */ 
1ong Ei1esize(FTLE *stream) 
( 

1ong curpos,1ength: 


curpos = fte11(stream)i 
Fseek(stream。 OL, SEEK_END): 
1ength = Ete11(stream): 
fseek(stream, Curpos 。 SEEK_SET)i 
return(1enght): 

} 


main() 
( 
FILE *streami 
Stream = fopen("MYEFILE.TXT" "rr")5 


printf("E11esize of MYFITLE.TXT is 21d* 
*bytes\n",f11esize(stream)): 


プロ グラ ム 出 力 


filesize of MYFILE.TXT is 15 bytes 
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fsetpos 

機能 スト リー ム 上 の ファ イル ポイ ンタ の 位置 を 設定 し ます 。 

形式 #include <stdio.h> 
int fsetpos(FILE * seg, const fpos t * pos) : 

プロ ト タ イ プ stdioh 

解説 fsetpos は 、 segz に 結び つけ られ て いる ファ イル ポイ ンタ を 新しい 位置 
に セッ ト し ます 。 新しい 位置 は 、 そ の syegw に 対し て fgetpos を 前 回 呼び 
出し た と き に 得 ら れ た 値 で す 。fsetpos は , seg ヵ が 指し て いる ファ イル の 
ファ イル 終了 標識 を クリ ア し , その ファ イル に 対す る ungetc の 効果 を 無 
効 に し ます 。 fgetpos を 呼び 出し た 後 は . そ の ファ イル に 対し て , 入力 また 
は 出力 を 行なう こと が で きま す 。 

戻り 値 fsetpos は 成功 し た 場合 0 を 返し ます 。 失 敗 し た 場合 は 0 以外 の 値 を 返し , 
eryzzo に 0 以外 の 値 を セッ ト し ます 。 

可 搬 性 fsetpos は ANSI C と 互換 性 が あり ます 。 

関連 項目 fgetpos、 fseek, ftell 
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fstat 


機能 オー プン ファ イル の 情報 を 得 ます 。 


形式 #include <sys\stat.h> 
int fstat (int Agzg/e, struct stat * sg の) : 


プロ ト タ イ プ sys\stath 


解説 fstat は , Agzge に 結び つけ られ て いる オー プン ファ イル また は ディ レク 
トリ に に 関す る 情報 を , stat 構造 体 の 中 に 格納 し ます 。 
sg の 7 は 、 stat 構造 体 (sys\stat.h の 中 で 定義 きれ て いる ) を 指し て いま 
す 。 そ の 構造 体 の 中 に は 次 の よう な フィ ー ル ド が 含ま れ て いま す 。 


3_ode オー プン ファ イル の モー ド に 関す る 情報 を 与え る ビッ トマ ス 
ク 

_dew 。 その ファ イル が ある ディ スク の ドラ イブ 番号 、 ま た は ファ イ 
ル が デバ イス 上 に ある 場合 に は ファ イル ハン ドル 

7 7dey 57 dey と 同じ 

2 ん 整定 数 1 に セッ ト 

ssze オー プン ファ イル の 大 き さ (バイ ト 数 ) 

7 ge オー プン ファ イル の 一 番 最近 修正 され た 日 時 

が 7 ge と 同じ 

See 57 ge と 同じ 


stat 構造 体 に は , これ 以外 に フィ ー ル ド が 3 つ あ り ま す が , MS-DOS で は 意 
味 を 持た な い の で 省略 し ます 。 

ビッ トマ スク は オー プン ファ イル の モー ド に 関す る 情報 を 含ん で お り , 各 
ビッ ト は 次 の よう な 意味 を 持っ て いま す 。 

次 の ビ ッ ト の うち , いずれ か 1 つが セッ ト さ れ ま す 。 


S_ IFCHR Agzde が デバ イス を 参照 し て いる 場合 
S_IFREG 通常 の ファ イル が 4gzge に よっ て 参照 され て いる 場合 
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戻り 値 


関連 項目 


178 


次 の 一 方 また は 両方 の ビッ ト が セッ ト さ れ ま す 。 


S_IWRITE ユー ザ が 書き 込み 許可 を 得 て い る 場合 
S_IREAD ユー ザ が 読み 込み 許可 を 得 て い る 場合 


ビッ トマ スク に は , さら に 読み 込み / 書 き 込 み ビ ッ ト も 含ま れ て いま す 。 こ 
れ ら は ファ イル の 許可 モー ド に し た が っ て セッ ト さ れ ま す 。 


fstat は 、 そ の オー プン ファ イル に 関す る 情報 を うま く 得 られ た 場合 は 0 を 
返し ます 。 エ ラー の 場合 (情報 が 得 ら れ な か っ た ) は -1 を 返し , eryo に 
EBADF (ファ イル ハン ドル が 正しく な い ) を セッ ト し ます 。 


accesS,。 Chmod、 stat 
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ftell 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


現在 の ファ イル ポイ ンタ を 返し ます 。 


#include <sdtio.h> 
long int ftell(FILE * seg) : 


stdio.h 

ftell は , segzz 中 の 現在 の ファ イル ポイ ンタ の 位置 を 返し ます 。 オ フ セ ッ 
ト は ファ イル の 先頭 か ら バ イト 単位 で 数 えま す 。 

ftell が 返し た 値 は 。 それ に 続く fseek の 呼び 出し で 使用 する こと が で きま 
補 


ftell は , 成功 し た 場合 、 現 在 の ファ イル ポイ ンタ 位置 を 返し ます 。 エ ラー 
の 場合 は -1L を 返し , eryzo に 正 の 値 を セッ ント し ます 。 


ftell は すべ て の UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ま 
す 。 


fgetpos、 fseek、 fsetpos, lseek、 rewind, tell 


fseek を 参照 し て くだ さい 。 
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ftime 


形式 


プロ ト タ イ プ 


戻り 値 


互換 性 


関連 項目 
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現在 の 時 刻 を timeb 構造 体 に 格納 し ます 。 


#include <sys\timeb.h> 
void ftime (struct timeb * 7) : 


sys\timeb.h 


ftime は 現在 の 時 刻 を 決定 し , が に よっ て 指 さ れる timeb 構造 体 の 各 フ 
ィ ー ル ド を 埋め ます 。 timeb 構造 体 は 、7ze、7 太 7z。72ezo7e、 の 77gg の 
4 つの フィ ー ル ド か ら な っ て いま す 。 


較 6 フィ ー ル ド は 、 グリ ニッ ジ 標 準 時 (GMT) 1970 年 1 月 1 日 00 : 00 : 
00 か ら の 経過 秒 数 を 与え ます 。 

較 2 が 0 フィ ー ル ド は , ミリ 秒 単位 で /ze の 端数 を 表わし ます 。 

田 ez の 6 フィ ー ル ド は 、GMT と ロー カル タイ ム と の 差 を 分 単位 で 示 
し ます 。 こ の 値 は GMT か ら 西 に 向かっ て 計算 され ます 。ftime は この 
値 を , tzset 関数 に よっ て セッ ト さ れ た グロ ー バ ル 変 数 が 7zezoze か ら 
取り 出し ます 。 

較 の 7725 フィ ー ル ド は ,。 その 時 間 帯 に お いて 夏時間 が 有効 で な い 場 合 
に は ゼロ に , その 時 間 和 帯 に お いて 夏時間 が 有効 を 場合 に は ゼロ で な い 
値 に セッ ト さ れ ま す 。 


注意 : ftime は tzset を 呼び 出し ます 。ftime を 使用 する こと が 明らか な 場 
合 に は tzset を 呼び 出す 必要 は あり ませ ん 。 


あり ませ ん 。 
ftime は UNIX シス テム V て 使用 で きま す 。 


asctime, ctime, gmtime、 localtime、 stime, time,、 tzset 
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例 nc1ude <etdio.h> 
nc1ude <eystimeb.h> 


main() 
{ 
gtruct timeb buf: 


ftime(gbuf): 

Printf(" メ 1d Seconds since 1-1-70 GMT\n' 。 buf.time): 

printf(*plus Zd mi11isecondswn* 。 buE.mi111tm): 

Printf("Zd Iinutes from GMT\n" 。 buE.t1mezone ) : 

Printf(*Day1ight avings Zs in effect\n', 
buf.dstE1ag 7 "ie" : "is not"): 
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fwrite 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 
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スト リー ム に デー タ を 書き ます 。 


#include <stdio.h> 


size t fwrite(const void * p/, size t sze, size t FILE * se が ) : 
stdio.h 


fwrite は 、 7 個 の デー タ ( 各 デ ー タ は sze バイ ト の 大 き さ ) を 指定 の 出力 
スト リー ム に 追加 し ます 。pr が 指す デー タ が 出力 され ます 。 

書き 込ま れる バイ ト 数 の 合計 は ( ヵ Xsze) と な り ま す 。 

pr は 、 どん な オプ ジェ クト で も 指 せ る よう に 宣言 され て いま す 。 


成功 し た 場合 , 実際 に 書き 込ん だ デー タ の 個数 を 返し ます (バイ ト 数 で は 
あり ませ ん )。 エ ラー が あっ た 場合 に は , デー タ 数 より 小さ な 値 を 返し ま 
す 。 


fwrite は すべ て UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ま 
す 。 


fopen、 fread 
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gcvt 

機能 浮動 小数 点数 を 文字 列 に 変換 し ます 。 

形式 #include <dos.h> 
char * gcvt(double yg/we, int 7dec, char *※ 7) : 

プロ ト タ イ プ stdioh 

解脱 gcvt は , ue を メル で 終わ る ASCII 文字 列 に 変換 し , その 文字 列 を の 
に 格納 し ます 。gcvt は , 可能 で あれ ば , FORTRAN の 変換 に 則 し て , 
9ec 桁 の 有効 数 字 を 生成 し ます 。F 変換 が 不可 能 な 場合 は 、 printff の E 形 
式 で (プリ ント 可能 な よう に ) 生成 し ます 。 後 ろ に 続く 意味 の な い 0 は 文字 
列 に 含ま れ ま せん 。 

戻り 値 gcvt は 、 が が 指す 文字 列 の アド レス を 返し ます 。 

可 搬性 gcvt は UNIX シス テム て 使用 で きま す 。 

関連 項目 ecyvt, fcvt 
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geninterrupt 


機能 ソフ トウ ェ ア 割 り 込 み を 生成 し ます 。 


形式 #include <dos.h> 


void geninterrupt(int 浪 7 zz): 
プロ ト タ イ プ dosh 


解説 geninterrupt マク ロ は 、 か zz に 指定 され た 割り 込み に 対す る ソフ ト 
ウェ アト ラッ プ を 引き 起こ す 働き を し ます 。 呼 び 出し 後 の す べ て の レジ ス 
タ の 状態 は 、 呼 び 出 され た 割り 込み に 依存 し ます 。 


戻り 値 あり ませ ん 。 
可 搬 性 geninterrupt は 80x86 ア ー キ テク チャ に 特有 の も の で す 。 
関連 項目 bdos, bdosptr, getyect, int86, int86x, intdos, intdosx, intr 
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機能 スト リー ム か ら 1 文 字 を 得 ます 。 


形式 #include <stdio.h> 
int getc(FILE * syegzz) : 


プロ ト タ イ プ stdio.h 


解説 getc は , 指定 の 入力 スト リー ム か ら 次 の 1 文字 を 読み 込ん で , その スト リー 
ム の ファ イル ポイ ンタ を イン クリ メン ト す る マク ロ で す 。 


戻り 値 成功 し た 場合 getc は 読み 込ん だ 文字 を 符号 拡張 せ ず に int 型 に 変換 し て 
返し ます 。 フ ァイル エン ド ま た は エラ ー の 場合 は EOF を 返し ます 。 


可 搬性 gete は UNIX シス テム て 使用 てき, ANSIC と 互換 性 が あり ます 。K&R 
で も 定義 きれ て いま す 。 
関連 項目 fgetc, getch, getchar, getche, gets, putc, putchar, ungetc 
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getcbrk 


機能 コン トロ ー ル プレ ー ク の 設定 を 得 ます 。 


形式 int getcbrk (void) : 


プロ ト タ イ プ dosh 


解説 getcbrk は , DOS の シス テム コー ル 0Ox33 を 使っ て , 現在 の コン トロ ー ル ブ 
レー クチ ェ ッ ク の 設定 を 返し ます 。 


戻り 値 getcbrk は 、 コ ント ロー ルプ レー クチ ェ ッ ク が オフ な ら 0, オン な ら 1 を 返 
し ます 。 
可 搬性 getcbrk は MS-DOS に 特有 の 関数 で す 。 


関連 項目 ctrbrk, setcbrk 
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失 能 キー ポー ド か ら エ コー バッ ク な し て 文字 を 読み 込み ます 。 
形式 int getch (void) : 


プロ ト タ イ プ conioh 


解説 getch は 、 コンソール か ら 直 接 1 文 字 を 読み 込む 関数 で す 。 エコ ー バ ッ ク は 
し ませ ん 。 getch は sg を 使用 し ます 。 


戻り 値 getch は , キー ポー ド か ら 読 み 込ん だ 文字 を 返し ます 。 エ ラー の 戻り 値 は あ 
り ま せん 。 

可 搬性 getch は MS-DOS に 特有 の 関数 で す 。 

関連 項目 cgets, fgetc, getc, getchar, getche, getpass, kbhit, putch, ungetch 
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getchar 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 
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sd か ら 文字 を 読み 込み ます 。 


#include <stdio.h> 
int getchar(void) : 


stdio.h 


getchar は 、 スト リー ム sg 上 の 次 の 1 文字 を 返す マク ロ で す 。 
これ は , getc(s/) と 定義 きれ て いま す 。 


成功 し た 場合 , getchar は 読み 込ん だ 文字 を 符号 拡張 せ ず に int 型 に 変換 
し て 返し ます 。 フ ァイル エン ド ま た は エラ ー の 場合 は EOF を 返し ます 。 


getchar は UNIX シス テム で 使用 で き , ANSIC と 互換 性 が あり ます 。K& 
R で も 定義 され て いま す 。 


fgetc, fgetchar, getc, getch, getche, putc, putchar, ungetc 


第 2 章 Turbo C ラ イプ ラリ 


getche 


機能 キー ボー ド か ら エ コー つき て 文字 を 読み 込み ます 。 
形式 int getche(void) : 
プロ ト タ イ プ conioh 


解説 getche は ,、 キー ボー ド か ら 1 文 字 を 読み 込み , 現在 の テキ スト ウィ ンド ウ に 
エコ ー バ ッ ク し ます 。 getche は BIOS を 使用 し ます 。 


戻り 値 getche は 読み 込ん だ 文字 を 返し ます 。 
可 搬 性 getche は MS-DOS に 特有 の 関数 で す 。 
関連 項目 cgets, cscanf, fgetc, getc, getch, getchar, kbhit, putch, ungetch 
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getcurdir 


機能 


形式 


プロ タイ プ 


戻り 値 


可 搬性 


関連 項目 
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指定 し た ドラ イブ の カレ ント ディ レク トリ を 得 ま す 。 

int getcurdir(int み iye, char * gzecoyy) 

dir.h 

getcurdir は , 指定 ドラ イプ の カレ ント 作業 ディ レク トリ の 名 前 を 得 ます 。 
ie に は ドラ イブ 番号 (0= カ レント, 1 ニ =A,...) を 指定 し ます 。 

g の 7ec7oy は 、 ヌル で 終わ る ディ レク トリ 名 が 格納 され る , 長き MAXDIR 
の メモ リ 領 域 指 し ます 。 ディレク トリ 名 に は ドラ イブ 名 は 含ま れず , 先 
頭 に 円 記号 半 も つき ませ ん 。 

getcurdir は 、 成功 し た 場合 は 0 を 返し 、 エラ ー の 場合 は -1 を 返し ます 。 


getcurdir は MS-DOS に 特有 の 関数 で す 。 


chdir, getcwd, getdisk, mkdir, rmdir 
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例 ま Hncude <dir.h> 
ncude <stdio.h> 
旭 nc1ude <string.h> 


char *current_directory(char *path) 


{ 
strcpy(path。 "X:W"): 
path[0] - "A' + getdisk(): 
getcurdir(0, pash+3): 
return(path): 

} 

main() 

{ 
char curdir[MAXPATH]i 
current directory(curdir): 
Printf("The current directory 1s Xs\n。 curdir): 

} 

プロ グラ ム 出 力 


The current directory 1s Ai\TURBOC 


Turbo C 標 準 関数 リフ ァ レ ンス 191 


getcwd 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬 性 


関連 項目 


192 


現在 の 作業 ディ レク トリ を 得 ま す 。 
char * getcwd(char * が, int が 77ez) : 
dir.h 


getewd は , 現在 の 作業 デア ィ レク トリ (ドラ イブ 名 も 含む ) の フル バス 名 を 
得る 関数 で す 。 最大 が 477ez 文字 まで 7 の 中 に 格納 し ます 。 フル バス 名 の 
長き (最後 の メル 文字 まで ) が 7ez より 長い 場合 は エラ ー に な り ま す 。 
の が NULL の 場合 は 自動 的 に malloc が 呼び 出さ れ , が 77ez バイ ト 分 の 
バッ ファ が 割り 当て られ ます 。 後 で , getcwd が 返し た 値 を 引数 と し て free 
関数 を 呼び 出せ ば . この バッ ファ を 解放 する こと が で きま す 。 


getcwd は 次 の よう な 値 を 返し ます 。 
較 7 が NULL で な か っ た 場合 , 成功 すれ ば が を 返し , 失敗 すれ ば 
NULL を 返し ます 。 
田 7 が NULL だ っ た 場合 は , 割り 当て た バッ ファ へ の ポイ ンタ を 返 
し ます 。 


エラ ー の 場合 は NULL を 返し ,、 グロ ー バ ル 変 数 errzo に 次 の いずれ か の 
値 を セッ ト し ます 。 


ENODEV 指定 の デバ イス が な い 
ENOMEM メモ リ が 不足 し た 
ERANGE 結果 が 範囲 を 越え た 


ge7cipg は MS-DOS に 特有 の 関数 で す 。 


chdir, getcurdir, getdisk, mkdir. rmdir 
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getdate 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬 性 


関連 項目 


MS-DOS の 日 付 を 得 ま す 。 


#include <dos.h> 
void getdate (struct date * gg/ep) : 


dos.h 


getdate は 、 シ ステ ム の 現在 の 日 付 を dg7ep が 指す date 構造 体 に 格納 し 
ます 。 
date 構造 体 は 次 の よう に 定義 きれ て いま す 。 


struct date { 


1nt da_yeari /* 年 */ 
char da_dayi 7* 日 */ 
char da_moni 7* 月 */ 
} 
あり ませ ん 。 


getdate は MS-DOS に 特有 の 関数 で す 。 


ctime, gettime, setdate, settime 
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例 nc1ude <etdio.h> 
#1nc1ude <dos.h> 


main() 

{ 
struct date todayi 
Struct time nowi 


getdate(&today): 
Printf("Today's date is zd/Zd/Zd\n*」 

today・da_year, today・da_mon,。 today.da_day): 
&ettime(&now): 


printf("The time ts 02d:Z02d:z02d.z02d\n" 
now.t1_hour。 now.t1_min。now.t1_sec。 now.t1_hund): 


プロ グラ ム 出 力 


Today's date is 1/1/1988 
The time is 17:08:22.00 
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getdfree 


機能 ディ スク の 未 使用 領域 の 大 き さ を 得 ま す 。 


形式 #include <dos.h> 
void getdfree(unsigned char み ye, struct dfree * gg の /e) : 


プロ ト タ イ プ dosh 


解説 getdfree は , み e で 指定 し た ドラ イブ (0= ニ デフ ォ ル ト , 1=A,.…) の デ 
ィ ス ク に 関す る 情報 を , rg が ec が 指す dfree 構造 体 に 格納 し ます 。 
dfree 構造 体 は 次 の よう に 定義 され て いま す 。 


struct dEree ( 


unsigned df aval1: /* 使用 可能 な クラ スタ 数 */ 
unsigned df t 5 /* 総 クラ スタ 数 */ 
d df beeci /* ユ セ クタ の バイ ト 数 */ 
unsigned dE sc1us: /* 1 ユ ク ラ スタ の セク タ 数 */ 
): 
戻り 値 getdfree は 値 を 返し ませ ん 。 エ ラー の 場合 は , dfree 構造 体 の の _se/s に 
-1 が セッ ト さ れ ま す 。 
可 折 性 getdfree は MS-DOS に 特有 の 関数 で す 。 


関連 項目 getfat, getfatd 
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getdisk 


機能 


形式 


プロ ト タ イ プ 
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カレ ント ドラ イブ を 得 ます 。 


int getdisk (void) ・ 


dir.h 


getdisk は 、 カレ ント ドラ イブ を 得 て , 整数 値 (0=A : , 1=B:, 2= 
C:,.….) を 返し ます 。DOS の シス テム コー ル 0x19 と 同じ で す 。 


getdisk は 、 カレ ント ドラ イブ 番号 を 返し ます 。 


getdisk は MS-DOS に 特有 の 関数 で す 。 


getcurdir, getcwd, setdisk 


getcurdrive を 参照 し て くだ さい 


第 2 章 Turbo C ラ イブ ラリ 


機能 ディ スク 転送 アド レス を 得 ます 。 
形式 char far * getdta(void) : 


プロ ト タ イ プ dosh 


解説 getdta は , ディ スク 転送 アド レス (DTA) の 現在 の 設定 を 返し ます 。 

スモ ー ル , ミディ アム の メモ リモ デル で は , セグ メン ト は 現在 の アー タ セ 
グ メ ント で ある と みな され ます 。 C の み を 使用 し て いれ ば そう な り ま す が , 
アモ セン プリ 言語 ルー チン を 使用 する と , ディ スク 転送 アド レス は どん な ハ 
ー ド ウェ アア ドレ ス に も 設定 する こと が で きま す 。 

コン バ パクト, ラー ジ ,。 ヒ ュー ジ の メモ リモ デル で は , getdta が 返す アド レ 
ス は 正しい ハー ドウ ェ ア ア ドレ ス で , プロ グラ ム の 外側 に 位置 づけ られ て 
いる こと も あり ます 。 


戻り 値 getdta は , 現在 の ディ スク 転送 アド レス を 指す far ポイ ンタ を 返し ます 。 
可 搬性 getdta は MS-DOS に 特有 の 関数 で す 。 


関連 項目 setdta 
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getenY 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 
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環境 か ら 文字 列 を 得 ます 。 

char * getenv(const char * 976@) ・ 

stdlib.h 

getenv は 、 指定 され た 環境 変数 の 値 を 返し ます 。 環 境 変数 名 は 大 文字 / 小 
文字 どちら で 書い て も か まい ませ ん が , 等 号 ( 三 ) を 含め て は いけ ませ ん 。 
指定 され た 環境 変数 が 見 つか ら な い 場 合 は getenv は 空 文字 列 を 返し ま 

す 。 

成功 し た 場合 geteny は zie に 結び つけ られ て いる 値 を 返し ます 。 指定 
し た zgze が 環境 の 中 で 定義 され て いな いり 場合 は , getenv は 空 文字 列 を 返 


し ます 。 


注意 : 環境 変数 を 直接 変更 する こと は で きま せん 。 環 境 の 値 を 変更 し た い 
場合 は , puteny 関数 を 使っ て くだ さい 。 


getenv は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


ez の roz( 変 数)、 getpsp, putenv 
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例 nc1ude <etdlo.h> 
nc1ude <std1ib.h> 


main() 
{ 
char *path, *dummy = NULL: 


Path = getenv("PATH*) : 
dummy = getenv("DUNGYY*) : 


PrintE("PATH = ZeWn"。 path): 

Printf("o1d value of DUMMY: zewnr 
(dummy == NOLL) ? **none 

putenv("DOMA4YeTURBOC" ) : 

dunmy = getenv(*DUNAMY*) 

Printf("new value of DUMMYi zewn*。 dummy)i 


: dummy): 


プロ グラ ム 出 力 


PATH = CiWBTNiC: ぜ BTNWDOS Ci 
o1d value of DUMMY: *none* 
new value of DUMMY: TURBOC 
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getfat 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 
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ファ イル アロ ケー ショ ン テ ー プ ブル 情報 を 得る 


#include <dos.h> 


void getfat(unsigned char の ye, struct fatinfo * gg の e) ・ 


dos.h 


getfat は , の zve で 指定 され た ドラ イブ (0 ニ = デフォルト, 1=A, 2 三 B,...) 
の ファ イル アロ ケー ショ ン テ ー ブ プル (FAT) か ら 情 報 を 取り 出し ます 。 
の gp/e は 、 情報 を 格納 する fatinfo 構造 体 を 指し ます 。 

getfat が 情報 を 格納 する fatinfo 構造 体 は 大 の よう に 定義 され て いま す 。 


struct fatinEo ( 


char Ei sc1usi /* ユ ク ラ スタ の セク タ 数 */ 
char fl fatidi /* FAT-1d バイ ト */ 
int fi_nclusi /* クラ スタ 数 */ 
nt fl byseci /* ユ セ クタ の バイ ト 数 */ 
}i 
あり ませ ん 。 


getfat は MS-DOS に 特有 の 関数 で す 。 


getdfree, getfatd 


第 2 章 Turbo C ラ イブ ラリ 


getfatd 
機能 ファ イル アロ ケー ショ ン テ ー プ ブル 情報 を 得 ます 。 
形式 #include <dos.h> 
void getfatd(struct fatinfo * grg2/e) : 
プロ ト タ イ プ dosh 
解説 getfatd は ,、 デフ ォ ル トド ライ ブ プ の ファ イル アロ ケー ショ ン テ ー ブ プル 
(FAT) か ら 情 報 を 取り 出し ます 。 ge は 、 情報 を 格納 する fatinfo 構 
造 体 を 指し ます 。 
getfatd が 情報 を 格納 する fatinfo 構造 体 は 次 の よう に 定義 され て いま す 。 
struct fatinfo { 
char Ei sclusi /* 1 クラ スタ の セク タ 数 */ 
char f1 fatid: /* FAT-1d バイ ト */ 
nt Ei nclus /* クラ スタ 数 */ 
nt fi byseci /* ユ セ クタ の バイ ト 数 */ 
) 
戻り 値 あり ませ ん 。 
可 搬 性 getfatd は MS-DOS に 特有 の 関数 で す 。 
関連 項目 getdfree, getfat 
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getftime 


機能 ファ イル の 日 付 と 時 刻 を 得 ます 。 


形式 #include <io.h> 
int getftime(int gzg/e, struct ftime * /7 み ep) : 


プロ ト タ イ プ ioh 


解説 getftime は 、 オー プン され て いる 4gzge に 結び つけ られ て いる ディ スク 
ファ イル の ファ イル 時 刻 ・ 日 付 を 取り 出し ます 。7zzep が 指し て いる ftime 
構造 体 に に ファ イル 時 刻 ・ 日 付 が 格納 され ます 。 
ftime 構造 体 は 大 の よう に 定義 る され て いま す 。 


struct Etime ( 


unstgned ft tseci 5i /* 秒 (2 秒 単位 ) */ 
unsigned ft mini 6: 7* 分 きた 
unsigned ft houri 5: /* 時 ku 
unsigned ft dayi 5: /* 日 k// 
unsigned ft monthi 4i 7/* 月 */ 
unetgned ft yeari 7: /* 年 一 1980 */ 
}: 
戻り 値 成功 し た 場合 、 getftime は 0 を 返し ます 。 


エラ ー の 場合 は -1 を 返し 、 eryzzo に 次 の いずれ か を セッ ト し ます 。 


EINFNC 無効 な ファ ンク ショ ン 番 号 
EBADF ファ イル 番号 が 正しく な い 


可 搬性 getftime は MS-DOS に 特有 の 関数 で す 。 


関連 項目 open, setftime 
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getpaSs 


機能 パス ワー ド を 読み ます 。 

形式 char * getpass(const char * pyo7P/) : 

プロ ト タ イ プ conioh 

解説 getpass は 、 ヌ ル 文 字 で 終わ る 文字 列 yoyjp7 を プロ ンプ ト と し て 表示 し , 


シス テム コン ソー ル か ら エ コー バッ ク な し で パス ワー ド を 読み 込み ます 。 
ヌル 文字 で 終わ る 最高 8 文字 (ヌル 文字 は 含め な い ) まで の 文字 列 を 指す ポ 


イン タ を 返し ます 。 

戻り 値 戻り 値 は 静 的 文字 列 へ の ポイ ンタ な の で , 呼び 出さ れる ご と に 上 書き され 
ます 。 

可 搬 性 getpass は UNIX シス テム て 使用 で きま す . 


関連 項目 getch 
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getpsp 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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プロ グラ ム セ グ メン ト プ レ フィ ックス を 得 ま す 。 

unsigned getpsp(void) : 

dos.h 

getpsp は , DOS の シス テム コー ル 0Ox62 を 使っ て ,. プ ログ ラム セグ メン ト プ 
レフ ィ ク ス (PSP) の セグ メン ト ア ドレ ス を 得 ま す 。 

この 呼び 出し は , MS-DOS 3.* に の み 存 在 し ます 。 MS-DOS 2 .x で は , ス 
ター ト ア ッ プ コー ド が セッ ト す る グロ ー バ ル 変 数 psp の 値 を ,. こ の か わり 
に 使う こと が で きま す 。 


getpsp は PSP の セグ メン ト ア ドレ ス を 返し ます 。 


getpsp は MS-DOS 3.* に 特有 の も の で す 。 こ れ よ り 前 の バー ジョ ン で は 
動作 し ませ ん 。 


getenv, psp( 変 数 ) 
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gets 

機能 s か ら 文 字 列 を 読み 込み ます 。 

形式 char * gets(char * 5) : 

プロ ト タ イ プ stdio.h 

解説 gets は , 標準 入力 ス トリ ー ム sd か ら , 復帰 文字 で 終わ る 文字 列 を 読み 込 
み , ゞ に 格納 し ます 。 復 帰 文字 は s の 中 で は ヌル 文字 ( ま 0) に 置き 換え ら 
れ ま す 。 
scanf と は 違っ て gets で は 入力 文字 列 中 に ホワ イト スペース (空白 タブ ) 
が あっ て も か まい ませ ん 。get は 復帰 文字 に 出会っ た と ころ で 読み 込み を 
や め , それ まで に 読み 込ん だ すべ て の 文字 を ゞ に コピ ー し ます 。 

戻り 値 成功 し た 場合 gets は 文字 列 引 数 s を 返し ます 。 フ ァイル エン ド あ る い は 
エラ ー の 場合 は NULL を 返し ます 。 

可 搬性 gets は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 

関連 項目 cgets, ferror, fgets, fputs, getc, puts 

例 #1nc1ude <stdio.h> 


main() 
6 
char buff[133]i 


Puts("Enter a stringi: ")』 
1f (gets(buEE) 1!= NOLL) 
printf(*String = "2"n"。 buff)j 
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gettime 


機能 シス テム 時 刻 を 得 ます 。 


形式 #include <dos.h> 


void gettime (struct time * zep) : 


プロ ト タ イ プ dosh 


解説 gettime は シス テム の 現在 の 時 刻 を , 7 が ep が 指す time 構造 体 に 格納 し ま 
。 
time 構造 体 は 大 の よう に 定義 され て いま す 。 


struct time ( 


unsigned char /* 分 / 
unsigned char /* 時 %/ 
unsigned char 7/* 1/100 秒 */ 
unsigned char /* 秒 */ 
): 

戻り 値 あり ませ ん 。 

可 搬性 gettime は MS-DOS に 特有 の 関数 で す 。 

関連 項目 getdate, setdate, settime, stime, time 
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getvect 

機能 割り 込み ベク タ エ ン トリ を 得 ます 。 

形式 void interrupt(* getvect(int /eyp7zo) ) () : 

プロ ト タ イ プ dosh 

解説 8086 フ ァ ミ リィ の すべ て の プロ セッ サ は , 割り 込み ベク タ の セッ ト を 持っ 
て お り , これ に は 0 一 255 の 番号 が ふら れ て いま す 。 各 ベ クタ の 中 の 4 バイ ト 
値 は , 割り 込み 関数 が 置か れ て いる 場所 を 示す アド レス で す 。 
getvect は , 7eyy4 の 7 の で 指定 され た 割り 込み ベク タ の 値 を 読み 出し , その 
値 を , 割り 込み 関数 を 指す (far) ポイ ンタ と し て 返し ます 。7eypzo の 
値 は 0-255 で な けれ ば な り ま せん 。 

戻り 値 getvect は 、 7z7err の 2 の で 指定 され た 割り 込み ベク タ の 現在 の 4 バイ ト 値 を 
返し ます 。 

可 搬 性 getvect は MS-DOS に 特有 の 関数 で す 。 

関連 項目 中 sable, enable, geninterrupt, setvect 
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例 ま #include <stdio.h> 
ま 1nclude <dos.h> 


/* getvect example */ 


Yoid interrupt (*o1dEunc)(): 
nt 1ooping = 1 


/* get_out - this 1s our new interrupt routine */ 


Yold interrupt get_out() 


6 
/* restore to origina1 nterrupt routine */ 
setvect(5,o1dfunc): 
1ooping = 0: 

} 


/* capture_prtescr - ngtal11s a new interrupt for 
<Shift><PrtSc> */ 


/* arguments : Func -- new interrupt functlon polnter */ 


vold capture_prtscr(yoid interrupt (*func)() ) 


{ 
/* save the old interrupt */ 
o1dfunc = getvect($S): 
/*insta11 our nterrupt hand1er */ 
setvect(5,Eunc)i 

} 

Yoid main () 

{ 


Puts("Press <Shift><Prt Sc> to terminate*): 
/* capture the print screen interrupt */ 
capture_prtscr(get_out): 


/* do noting */ 
yhi1e (1ooping): 


puts("Success* ): 
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に ーー 
getverify 


機能 DOS の ベリ ファ イフ ラグ の 状態 を 返し ます 。 


形式 int getverify (void) : 


プロ ト タ イ プ dos.h 


解説 getverify は 、 べ ベリファイ フラ グ の 現在 の 状態 を 得 ます 。 
べ ベリ ファ イフ ラグ は ディ スク へ の 出力 を 制御 し ます 。 ベ リフ ァ イ が オフ の 
と き に は 書き 込み の 照合 (ベリ ファ イ ) は 行なわ れず , ベリ ファ イ が オン 
の と き は すべ て の ディ スク へ の 書き 込み に お いて , デー タ が 適切 に 書き 出 
きれ た か どう か を 確か め る た め に 照合 が 行なわ れ ま す 。 


戻り 値 getverify は 、 ベリファイ フラ グ の 現在 の 状態 (0 か 1) を 返し ます 。 


に 2 


べり ファ イフ ラグ オフ 
べり ファ イフ ラグ オン 


可 搬性 getverify は MS-DOS に 特有 の 関数 で す 。 


関連 項目 setverify 
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getw 

機能 スト リー ム か ら 整 数 を 読み 込み ます 。 

形式 #include <stdio.h> 
int getw(FILE * seg7z) : 

プロ ト タ イ プ stdio.h 

解説 getw は , 入力 スト リー ム syeg か ら 次 の 整数 を 読み 込み ます 。 getw は 。 
ファ イル の 中 の 境界 (アラ イン メン ト ) を 考慮 し ませ ん 。 
getw は 、 テ キス トモ ー ド で オー プン され た スト リー ム に 対し て は 使用 す 
べき で は あり ませ ん 。 

戻り 値 getw は , 入力 スト リー ム seg 上 の 次 の 整数 を 返し ます 。 フ ァイル エン 
ド あ る い は エラ ー の 場合 は EOF を 返し ます 。EOF は getw が 通常 の 値 と 
し て 返す も の な の で , ファ イル エン ド あ る い は エラ ー を 検出 する た め に は , 
feof や ferror を 使う 必要 が あり ます 。 

可 搬性 getw は UNIX シス テム て 使用 で きま す 。 

関連 項目 putw 
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gmtime 
機能 日 付 お よび 時 刻 を グリ ニッ チ 時 間 に 変 換 し ます 。 
形式 #include <time.h> 


プロ ト タ イ プ 


解説 


戻り 値 


struct tm * gmtime(const time t * timer) : 


time.h 


gmtime は , time が 返し た 値 の アド レス を 引数 に と り , 分 解 さ れ た 時 刻 が 
含ま れ て いる tm 型 の 構造 体 へ の ポイ ンタ を 返し ます 。 gmtime は 、GMT 
(グリ ニッ ジ 標 準 時 ) へ の 変換 を 行ない ます 。 

long 型 の グロ ー バ ル 変 数 zezoze は , GMT と 地方 標準 時 と の 差 を 秒 単 
位 で 保持 し て いる 必要 が あり ます (PSTー 太 平 洋 標準 時 の 場合 に は 8X 
60X60)。 グ ロー バル 変数 dzg/g/ は , 夏時間 の 期間 中 に の み 0 以 外 の 値 を 
と り ま す 3 

構造 体 tm は , time.h の 中 で 以下 の よ うに 定義 され て いま す 。 


struct 
nt 
nt 
nt 
nt 
1nt 
nt 
nt 
1nt tm ydayi 
1nt tm edeti 

}: 


これ ら は , 24 時 間 制 の 時 刻 、 日 (1 一 31)。 月 (0 一 11), 曜日 (日 曜 が 0), 
年 の 下 2 桁 (年 -1900)。 年 内 で の 日 (0 一 365), 夏時間 か どう か の フラ グ ( 夏 
時 間 の 間 は 0 以外 の 値 ) を 示し て いま す 。 


gmtime は , 時 刻 が 分 解 さ れ て 入っ て いる 構造 体 を 指す ポイ ンタ を 返し ま 
す 。 こ の 構造 体 は 静 的 デー タ で , 呼び 出し が 行なわ れる ご と に 上 書き され 
ます 。 
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212 


gmtime は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 


asctime, ctime, ftime, localtime, stime, time, tzset 


す #1nclude <stdio.h> 
#1nclude <std1ib.h> 
す #1nclude <time.h> 


matn() 

{ 
struct tm *t1meptr: 
time_t secsnowi 


timezone = 8* 60* 60: 


/* 1970-01-01 00:00:00 か ら の 経過 秒 数 を 得る */ 
time(&secsnow)i 


/* GMT に 変換 */ 

timeptr = gmtime(&secsnow): 

Printf("The date 1s Zd-Zd-19702d\n* 。 
(tlmeptr -> tm mon) + 1。 timeptr -> tm mday, 
tmeptr -> tm year): 

printf("Greenw1th Mean T1me 1s Z02dZ02d:Z02d\n\n" 。 
timeptr -> tm hour, timeptr -> tm min 
timeptr -> tm sec)i 


プロ グラ ム 出 力 


The date ts 2-2-1988 
Greenwitch Mean Time 1e 20:44:36 
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harderr 


機能 ハー ドウ ェ ア エ ラー ハン ドラ を 確立 し ます 。 
形式 Yoid harderr(int (* ヵ gzg/) () ) : 
プロ ト タ イ プ dosh 


解説 harderr は , 現在 の プロ グラ ム に 対す る ハー ドウ ェ ア エ ラー ハン ドラ を 定 
め ま す 。 こ の エラ ー ハ ンド ラ は , 割り 込み 0x24 が 起こ っ た と き に 呼び 出さ 
れ ま す (割り 込み に に つい て は 。 MS.DOS プロ グラ マー ズリ ファ レン スー 
ニュ アル を 参照 し て くだ さい ) 。 
その よう を な 割り 込み が 起き た と き に , 4gzger が 指す 関数 が 呼び 出さ れ ま 
す 。 ハ ンド ラ 関 数 は 次 の よう な 引数 を と も な っ て 呼び 出さ れ ま す 。 


hand1er(int errva1。 int ax。 int bp。 nt si): 


@7v の 7 は 。 DOS に よっ て DI レジ スタ に セッ ト さ れる エラ ー ュ コー ド で す 。 
9*, は 、DOS が AX, BP, Sf レジ スタ に セッ ト す る 値 で す 。 


一 2x は 、 ディ スク ある い は 他 の デベ バイ ス の どちら で エラ ー が 起き た の 
か を 示し ます 。 gx が 負 で な い 値 で あれ ば ディ ス クエ ラー を 示し , 負 で 
あれ ば 他 の デバ イス エラ ー を 示し ます 。 ディ ス クエ ラー の 場合 2x と 
Ox00FF の AND を と る と ,、 エラ ー の 起き た ドラ イ プ 番 号 (1= ニ A, 2= 
B,...) を 得る こと が で きま す 。 

較 め と の 2 つ で , エラ ー の 起き た ドラ イ プ の デバ イス ドラ イ バ ヘ ッ ダ 
を 指し ます 。 


4gzger が 指し て いる 関数 が 直接 呼び 出さ れる こと は あり ませ ん 。Harderr 
が , その 関数 を 呼び 出す DOS 割り 込み ヘン ドラ を 確立 し ます 。 

peek と peekb を 使う と ,。 この ドラ イ バ ヘ ッ ダ か ら デ バイ ス に 関す る 情報 
を 得る こと が で きま す 。 
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戻り 値 


可 搬性 


関連 項目 


214 


ドラ イ バ ヘ ッ ダ は , poke ある い は pokeb に よっ て 変更 する こと は で きま 
せん 。 

ハン ドラ の 中 で は 1 か ら 0xC まで の DOS コー ル を 発行 する こと が で きま 
す が , これ 以外 の DOS コー ル は MS-DOS を こわ すこ と に な り ま す 。 特 
に , すべ て の C 標 準 1/0 ある い は UNIX エミ ュ レ ーション 1/O を 呼び 出 
すこ と は で きま せん 。 

ハン ドラ は , 0 (無視 )、1 ( 再 試行 )、2 (異常 終了 ) の いずれ か の 値 を 返さ 
な けれ ば な り ま せん 。 


あり ませ ん 。 
harderr は MS-DOS に 特有 の 関数 で す 。 


hardresume, handretn, peek, poke 
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例 ま 1nc1ude <stdio.h> 
すず include <dos.h> 


#define DISPLAY STRTNG 0x09 
す define IGNORE 0 
す #define RETRY 1 
#define ABORT 2 


1nt hand1er(int errva1 。 int ax。 int bp。 nt si) 
【 
char msg[25]: nt drivei 


/* デバ イス エラ ー */ 

1f (ax < 0) 

( 
/* DOS ファ ンク ショ ン 0 - 0x0C の み が 使用 可能 */ 
bdosptr(DTSPLAY_STRTNG, "device errore$", 0)5 
hardretn(-1): /* 呼び 出し プロ グラ ム に 戻る */ 

} 

drive = (ax & OxO0FF): 

Sprintf(meg, "disk error on drive ZcS"。 *A' + drive)i 

bdosptr(DTSPLAY_STRTNG, msg, 0): 

Feturn(ABORT) : /* 呼び 出し プロ グラ ム を 和 扶 常 終了 させ る +*/ 

} 


main() 
( 
harderr(hand1er): 


Printf("Make sure there 1s no disk in drive Ai\n"): 
Printf("Press a key when ready...\n'): 
getch(): 


Printf("Attempting to access AiWn")i 
fopen("ArANY.FTL"' 。"r"): 


プロ グラ ム 出 力 


Make sure there ts no diek in drive Ar 
Pless a key when ready... 

Attempttng to access Ar 

disk error on driveA 
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hardresume 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 
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ハー ドウ ェ ア エ ラー ハン ドラ 関数 で す “* 
void hardresume (int xye/) : 


dos.h 


harderr に よっ て 確立 され た エラ ー ハ ンド ラ は , hardresume を 呼び 出し 
て DOS へ 制御 を 戻す こと が で きま す 。 hardresume の gx/er (結果 コー ド ) 
は , 異常 終了 (2), 再 試行 (1), 無視 (0) の いずれ か の 値 を も ち ま す 。 異 
常 終了 は , DOS 割り 込み 0x23 (コン トロ ー ル プレ ー ク 割り 込み ) の 呼び 出 
し に よっ て 行なわ れ ま す 。 

ハン ドラ は , 0 (無視 ), 1 ( 再 試行 )、 2 (異常 終了 ) の いずれ か の 値 を 返さ 


な けれ ば な り ま せん 。 
あり ませ ん 。 


hardresume は MS-DOS に 特有 の 関数 で す 。 


harderr, hardretn 
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hardretn 


機能 ハー ドウ ェ ア エ ラー ハン ドラ 関数 で す 。 

形式 void hardretn (int 7ez) : 

プロ ト タ イ プ dos.h 

解説 harderr に よっ て 確立 され た エラ ー ハ ンド ラ は , hardretn を 呼び 出し て , 
直接 アプ リケーション プロ グラ ム に 戻る こと が で きま す 。 
ハン ドラ は , 0 (無視 )、1 ( 再 試行 )、2 (異常 終了 ) の いずれ か の 値 を 返さ 
な けれ ば な り ま せん 。 

戻り 値 あり ませ ん 。 

可 搬性 hardretn は MS-DOS に 特有 の 関数 で す 。 


関連 項目 harderr, hardresume 


例 harderr を 参照 し て くだ さい 。 
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hypot 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


218 


直角 三角 形 の 斜 辺 の 長 さ を 計算 し ます 。 


#include <math.h> 
double hypot(double *, double y) : 


math.h 
hypot は , 次 の 式 を 満た す よ うな z の 値 を 計算 し ます 。 
22 三 キア か つ . z> 三 0 


これ は , 直角 三角 形 の 直角 を は さむ 2 辺 の 長 さ x と y が わか っ て いる 場合 
に , 斜 辺 の 長き を 求め る こと と 等 し く な り ま す 。 


成功 し た 場合 、hypot は z を double で 返し ます 。 エ ラー の 場合 (オー バー 
フロ ー な ど ) は HUGE_VAL を 返し , eryzo に 次 の 値 を セッ ト し ます 。 


ERANGE 結果 が 範囲 を 越え た 
hypot の エラ ー 処 理 は 、 matherr 関数 を 使っ て 変更 する こと が で きま す 。 


hypot は UNIX シス テム て で 使用 で きま す 。 
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機能 ハー ドウ ェ ア ポ ー ト か ら 1 ワ ー ド を 読み 込み ます 。 


形式 #include <dos.h> 
int inport(int porZ) : 


プロ ト タ イ プ dosh 


解説 inport は 、 por42 に 指定 し た 入力 ポー ト か ら 1 ワ ー ド 読み 込み ます 。 
戻り 値 inport は 、 読み 込ん だ 値 を 返し ます 。 

可 搬 性 inport は 80x86 フ ァ ミ リィ に 特有 の 関数 で す 。 

関連 項目 inportb, outport, outportb 
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inportb 

機能 ハー ドウ ェ ア ポ ー ト か ら 1 バ イト 読み 込み ます 。 

形式 unsigned char inportb(int porZ) 

プロ ト タ イ プ dosh 

解説 inportb は , por7 に 指定 し た 入力 ポー ト か ら 1 バ イト を 読み 込む セ マ ク ロ で 
す 。 
inportb は 、dos.h が イン クル ー ド され て いる 場合 は ., インライン コード に 
展開 され る マク ロ と し て 扱わ れ ま す 。 
dosh を イン クル ー ド し て いな い 場 合 や 、dos.h は イン クル ー ド し て も 
inportb マク ロ を #undef し て いる 場合 に は 関数 と し て 扱わ れ ま す 。 

戻り 値 inportb は , 読み 込ん だ 値 を 返し ます 。 

可 搬性 inportb は 80x86 フ ァ ミ リィ に 特有 の 関数 で す 。 

関連 項目 inport, outport, outportb 
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int86 

機能 8086 ソ フト ウェ ア 割 り 込 み を 行ない ます 。 

形式 #include <dos.h> 
int int86(Gint 好 の , union REGS * 7egy, union REGS * oegs) : 

プロ ト タ イ プ dosh 

解説 int86 は , 引数 zo で 指定 され た 8086 ソ フト ウェ ア 割 り 込 み を 実行 し ま 
す 。 ソ フト ウェ ア 割 り 込み を 実行 する 前 に , 7egs 中 の 値 を 各 レ ジス タ に コ 
ピー し ます 。 
ソフ トウ ェ ア 割 り 込み が 終わ る と 、 int86 は , 現在 の レジ スタ の 内 容 を 
24 の egs に コピ ー し ,. キャ リー フラ グ の ステ ー タ ス を oegs の x の 7gg フ 
ィ ー ル ド に コピ ー し , さら に 8086 の フラ グレ ジス タ の 値 を oegy の * 
gy フィ ー ル ド に コピ ー し ます 。 
キャ リー フラ グ が セッ ト さ れ て いる 場合 は , 通常 は エラ ー が 起き た こと を 
意味 し ます 。 
7egS は 、 ou/egy と 同じ 構造 体 を 指し て いて も か まい ませ ん 。 

戻り 値 int86 は , ソフ トウ ェ ア 割 り 込 み 終了 時 の AX レジ スタ の 値 を 返し ます 。 キ 
ャ リー フラ グ が セッ ト さ れ て いる と き (outregs->x.flag ! 王 0) は エラ ー を 
意味 し 、_goserrzo に エラ ー コ ー ド が セッ ト さ れ ま す 。 

可 搬性 int86 は 80x86 ア ー キ テク チャ に 特有 の 関数 で す 。 

関連 項目 bdos, bdosptr, geninterrupt, int86x, intdos, intdosx, intr 
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例 #1nc1ude <dos.h> 
す #define BTOS 0x18 


/* カー ソル 位置 の 設定 (x 桁 , y 行 ) */ 
void gotoxy(int xint y) 
{ 

union REGS regsi 


regs・h.ah = 0x13 
regs.x.dx = (((y - 1)*80)+xー1)*2: 
1nt86(BIOS, &regs, &reg8): 

} 
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int86x 


機能 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 


8086 ソ フト ウェ ア 割 り 込 み イ ンタ ー フ ェ ー ス で す 。 


#include <dos.h> 
int int86x (int の , union REGS * egs, union REGS * oz//egs, 
struct SREGS * seg7egs) : 


dos.h 


int86x は , 引数 放 o で 指定 され た 8086 ソ フト ウェ ア 割 り 込み を 実行 し ま 
す 。 ソ フト ウェ ア 割 り 込 み を 実行 する 前 に , 7egs 中 の 値 を 各 レ ジス タ に コ 
ピー し ます 。int86x は さら に , seg7egs->* の と seg7egs->x.@ の 値 を 対応 す 
る レジ スタ に 置き ます 。 こ れ に よっ て , far ポイ ンタ を 使う プロ グラ ム や , 
ラー ジ デ ー タ モデ ル の プロ グラ ム で , ソフ トウ ェ ア 割 り 込み の 実行 中 に 使 
用 する セグ メン ト を 指定 で きる よう に な り ま す 。 

ソフ トウ ェ ア 割 り 込み か ら 戻 る と , int86x は , 現在 の レジ スタ の 内 容 を 
の 4 の eg8y に コピ ー し , キャ リー フラ グ の ステ ー タ ス を og7egs の xc/7gg フ 
ィ ー ル ド に コピ ー レ し , 8086 の フラ グレ ジス タ の 値 を ozegs の x/7ggs フィ 
ー ル ド に コビー し ます 。 int86x は さら に , DS を 回 復 し , segregs->es と 
Seg7e8S-〉> の に 対応 する セグ メン トレ ジス タ の 値 を セッ ト し ます 。 キ ャ リー 
フラ グ が セッ ト さ れる 場合 は , 通常 は エラ ー が 起き た こと を 意味 し ます 。 
int86x は , デ フォ ルト の デー タ セ グ メ ント と は 異な る DS の 値 や , ES の 値 
を 必要 と する 8086 ソ フト ウェ ア 割 り 込 み を 呼び 出す 場合 に 使う) こと が で き 
ます 。 


int86x は 、 ソフ トウ ェ ア 割 り 込み 終了 時 の AX レジ スタ の 値 を 返し ます 。 
キャ リー フラ グ が モッ ト さ れ て いる と き (outregs->x.flag ! 王 0) は エラ ー 
を 意味 し 、 goserrzo に エラ ー コ ー ド が セッ ト さ れ ま す 。 


int86x は 80x86 ア ー キ テク チャ に 特有 の 関数 で す 。 


bdos, bdosptr, geninterrupt, intdos, intdosx, int86, intr, segread 
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DOS 割り 込み イン ター フェ ー ス で す 。 


#include <dos.h> 
int intdos(union REGS * 7egs, union REGS * oegs) : 


dos.h 


intdos は DOS 割り 込み 0x21 を 実行 し て , 指定 の DOS ファ ンク ショ ン を 
呼び 出し ます 。 regs-> ん g7 の 値 に よっ て , 呼び 出さ れる DOS ファ ンク シ 
ョ ン が 決ま り ま す 。 

intdos は 、DOS ファ ンク ショ ン を 実行 する 前 に , 7egs 中 の 値 を 各 レ ジス 
タ に コピ ー し ます 。 

Ox21 割 り 込 みか ら 戻る と 、intdos は , 現在 の レジ スタ の 内 容 を の 77egy に 
コピ ビー し, キャ リー フラ グ の ステ ー タ ス を oegs の xg7gg フィ ー ル ド に 
コピ ビー し, さら に 8086 の フラ グレ ジス タ の 値 を oyegs の x.7ggs フィ ー ル 
ド に コピ ー し ます 。 

キャ リー フラ グ が セッ ト さ れ て いる 場合 は 通常 は エラ ー が 起こ っ た こと 
を 意味 し ます 。 

7egs は 。 ogegy と 同じ 構造 体 を 指し て いて も か まい ませ ん 。 


intdos は 、DOS ファ ンク ショ ンコ ー ル 終了 時 の AX レジ スタ の 値 を 返し 
ます 。 キ ャ リー フラ グ が セッ ト さ れ て いる と き (outregs->x.cflag ! 王 0) 
は エラ ー を 意味 し , gdoseryyzo に は エラ ー コ ー ド が セッ ト さ れ ま す 。 


intdos は MS-DOS に 特有 の 関数 で す 。 


bdos, geninterrupt, int86, int86x, intdosx, intr 
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例 まお Hnclude <stdio.h> 
nclude <dos.h> 


/* ファ イル 名 の 削除 : 成 坊 すれ ば 0, 失 骸 する と 0 以外 を 返す */ 


1nt delete_fi1e(char near *f11ename) 
6 

unton REGS regsi 

int reti 


regs.h.ah = 0x41: /* ファ イル 削除 */ 
rege・x-dx = (unsigned) 11ename: 

ret = intdos(&rege, &regs): 

/* キャ リー フラ グ が セッ ト さ れ て いれ ば エラ ー +*/ 
return(rege.x.cf1ag ? ret : 0): 


} 


main() 
( 
1nt erri 
err = delete_ file("NOTEXTST.SS$"): 


printf("Able to delete NOTEXTST.$$$: Zs\n", 
(lerr) 7 "YES" :』 "NO"): 


プロ グラ ム 出 力 


Ab1e to delete NOTEXTST.$S$$: NO 
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DOS 割り 込み イン ター フェ ー ス で す 。 


#include <dos.h> 
int intdosx (union REGS * 謝 /egs, union REGS * og/7egs, 
struct SREGS * seg7egs) ・ 


dos.h 


intdosx は , DOS 割り 込み 0x21 を 実行 し て , 指定 の DOS ファ ンク ショ ン を 
呼び 出し ます 。regs-> ん g7 の 値 に よっ て , 呼び 出さ れる DOS ファ ンク シ 
ョ ン が 決ま り ます 。intdosx は 、 DOS ファ ンク ショ ン を 実行 する 前 に , 
六 7egs 中 の 値 を 各 レ ジス タ に コピ ー し レ し , seg7egs->*. の と seg7egs->X.es の 値 
を 対応 する レジ スタ に 置き ます 。 これ に よっ て , far ポイ ンタ を 使う ブロ グ 
ラム や , ラー ジ デ ー タ モデ ル の プロ グラ ム で , ファ ンク ショ ング の 実行 中 に 
使用 する セグ メン ト を 指定 で きる よう に な り ま す 。 

0x21 の 割り 込み が 終わ る と, intdosx は , 現在 の レジ スタ の 内 容 を oz/egs 
に コピ ー し , シス テム の キャ リー フラ グ の ステ ー タ ス を ogegs の xc77gg 
フィ ー ル ド に コピ ー し , さら に 8086 の フラ グレ ジス タ の 値 を ozegs の x 
77zgy フィ ー ル ド に コピ ー し ます 。intdosx は さら に , DS を 回 復 し , segyegs 
->es と seg7egs-> の に 対応 する セグ メン トレ ジス タ の 値 を セッ ト し ます 。 
キャ リー フラ グ が セッ ト さ れ て いる 場合 は 、 通常 は エラ ー が 起こ っ た こと 
を 意味 し ます 。 

intdosx は 、 デ フォ ルト の デー タ セ グ メ ント と は 異な る DS の 値 や , ES の 
値 を 必要 と する DOS ファ ンク ショ ン を 呼び 出す 際 に 使う こと が で きま す 。 
婦 7e8S は 、 の degS と 同じ 構造 体 指 し て いて も か まい ませ ん 。 


intdosx は , DOS ファ ンク ショ ンコ ー ル 終了 時 の AX レジ スタ の 値 を 返し 
ます 。 キ ャ リー フラ グ が セッ ト さ れ て いる と き (ogegs->x.cflag ! 三 0) 


は エラ ー を 意味 し , goserrzo に は エラ ー コ ー ド が セッ ト さ れ ま す 。 


intdosx は MS-DOS に 特有 の 関数 で す 。 
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関連 項目 bdos, geninterrupt, int86, int86x, intdos, intr, segread 


例 1nclude <stdio.h> 
まお include <dos.h> 


/* ファ イル 名 の 削除 : 成功 すれ ば 0, 失敗 する と 0 以外 を 返す */ 


int delete_file(char far *filename) 
( 

union REGS regsi 

struct SREGS sregei 

nt ret: 


regs.h.ah = 0x41: /* ファ イル 削除 */ 
regs.x.dx = FP OFF(Ei1ename): 
sregs・ds = FP SEG(Ei1ename): 
ret = intdosx(&regs, &regs)』 
/* キャ リー フラ グ が セッ ト さ れ て いれ ば エラ ー +*/ 
return (regs.x.CFlag ? ret : 0): 

} 


matn() 
( 
nt erri 
err = delete fil1e(*NOTEXTST.SS$"): 


Printf("Ab1e to delete NOTEXTST.S$$:』 Zen'。 
(ierr) 7 "YES* 』 *NO'): 


プロ グラ ム 出 力 


Ab1e to delete NOTEXTST.$$$: NO 
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も う 1 つ の 8086 ソ フト ウェ ア 割 り 込 み イ ンタ ー フ ェ ー ス で す 。 


#include <dos.h> 
void intr(int zo, struct REGPACK * yeg) : 


dos.h 


intr 関数 は , ソフ トウ ェ ア 割 り 込み を 実行 する た め の も う 1 つ の イン ター 
フェ ー ス で す 。 引数 放 o で 指定 され た 8086 ソ フト ウェ ア 割 り 込み を 生成 
し まお 。 

intr は , ソ フト ウェ ア 割 り 込み の 実行 の 前 に , REGPACK 構造 体 * eg の 
中 の 各 値 を , 対応 する レジ スタ に コピ ー し ます 。 ソ フト ウェ ア 割 り 込み が 
終わ る と , intr は , 現在 の レジ スタ の 値 を 、 フ ラグ も 含め て /yeg の 中 に ユ 
ビー し まず 。 

intr へ 渡さ れる 引数 は 次 の 2 つ で す 。 


如 が の 実行 され る べき 割り 込み 番号 

eg 以下 の 値 を 持つ 構造 体 の アド レス 
(a) 呼び 出し 前 は , 入力 する レジ スタ の 値 
(b) 割り 込み 後 は , 現在 の レジ スタ の 値 


REGPACK 構造 体 は dos.h の 中 で 次 の よう に 定義 され て いま す 。 


struct REGPACK 
{ 

unsigned r_ax。r bx。r cx。r dxi 

une1gned r_bp。r_e1。r di。r de。r es,。r flagei 
): 


intr は 値 を 返し ませ ん 。REGPACK 構造 体 * み eg に, 割り 込み 後 の レ ジス 
タ の 値 が 入っ て いま す 。 


intr は 80x86 ア ー キ テク チャ に 特有 の 関数 で す 。 
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関連 項目 geninterrupt, int86, int86x, intdos, intdosx 
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1/O デバ イス を 制御 し ます 。 


int ioctl(int Agzge, int 74zc [、void * の gr, int grgcr] ) ・ 


io.h 


これ は , DOS の シス テム コー ル 0x44 (IOCTL) へ の 直接 の イン ター フェ ー 
ス で す 。 具体 的 な ファ ンク ショ ン は , 7&zc の 値 に よっ て 次 の よう に な り ま 
す 。 


デバ イス コン トロ ー ル デー タ を 得る 

デバ イス コン トロ ー ル デー タ を セッ ト す る (ggg み x の 値 ) 

gg の が 指す アド レス に , gc バイ ト 読 み 込む 

@ の g の が が 指す アド レス か ら , gzgex バイ ト 書 き 出 す 

2 と は ほぼ 同じ し , た だ し 4gzde を ドラ イブ 番号 と し て 扱う (0 ニ デ フ 

ォ ル ト , 1= ニ A な ど ) 

5 3 と ほぼ 同じ し 、 た だ し 4gz の 6e を ドラ イブ 番号 と し て 扱う (0 ニ デ フ 
ォ ル ト , 1=A な ど ) 

6 入力 ステ ー タ ス を 得る 

7 出力 ステ ー タ ス を 得る 

8 メデ ィ ア の 交換 性 の テス ト (DOS 3.x の み ) 

11 リト ライ 回 数 の 設定 (DOS 3.x の み ) 


ょ らら らら テー の 


ioctl は 、 デバイス チャ ネル に 関す る 情報 を 得る た め に 使用 し ます 。7&zc が 
0 6, 7 で は , 通常 の ファ イル も 指定 で きま す 。 それ 以外 の 値 の 場合 に は 
EINVAL エラ ー を 返し ます 。 

シス テム コー ル 0x44 の 引数 や 戻り 値 に 関す る 詳細 は , MS-DOS の プロ グラ 
マー ズリ ファ レン スマ ニュ アル を 参照 し て くだ さい 。 

引数 yg の x お よび gcr は オプ ショ ン で す 。 
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戻り 値 


可 搬性 


例 


ioctl は , 特殊 な を ファ ンク ショ ン に 対す る MS-DOS2.0 デ バイ ス ド ラ イベ バ へ 
の 直接 的 な イン ター フェ ー ス を 提供 し ます 。 こ の 関数 の 厳密 な 動作 は 各 
社 の ハー ドウ ェ ア や デバ イス に よっ て 異な り ,、 サ ポート し て いな いり 場合 も 
あり ます 。ioctl の 使い 方 に 関し て は 使用 する シス テム の BIOS に 関す る マ 
ニュ アル を 参照 し て くだ さい 。 


74zc が 0 ある い は 1 の 場合 戻り 値 は デバ イス 情報 (IOCTL 呼び 出し の DX 
レジ スタ の 値 ) で す 。 

74zc が 2 一 5 の 場合 は 戻り 値 は 実際 に 転送 えれ た バイ ト 数 で す 。 

7zzc が 6 一 7 の 場合 り 値 は アデ バイ スス テー タス で す 。 

エラ ー が 起き た 場合 は -1 を 返し , eryzo に 次 の いずれ か の 値 を セッ ト し ま 
す 。 


EINVAL 引数 が 正しく な い 
EBADF ファ イル 番号 が 正しく な い 
EINVDAT データ が 正しく な い 


ioctl は UNIX シス テム て 使用 で きま す が , 引数 や 機能 は 異な り ま す 。 
UNIX バー ジョ ン 7 と シス テム III と で は , ioctl の 使用 法 が 異な り ま す 。 
MS-DOS で 使用 し た ioctl 呼び 出し を その まま UNIX で 使用 する こと は 
で きま せん 。 ま た , MS-DOS マシ ン 間 の 可 搬性 も ほとん ど あ り ま せん 。 
MS-DOS 3.* で , 7zc の 値 と し て 8 と 11 の 機能 が 追加 され まし た 。 


ま #1nclude <stdio.h> 
ま 1nclude <io.h> 
#Hnclude <dir.h> 


main() 
( 
1nt stati 
stat = 1oct1(0.8,0.0): /* ファ ンク ショ ン 8 で , メ ディ ア が d/ 
/* 交換 性 可能 な か どう か を 調べ る */ 
printf(*"Drive Zc Zs changeab1e\n" 。 
getdisk() + "A'。 (stat =s 0) ? "is" : "is not")5 


プロ グラ ム 出 力 


Drive A is not changeable 
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文字 が 英字 ある い は 数 字 で ある か どう か を 判定 し ます 。 


#include <ctype.h> 


int isalnum(int c) : 

ctype.h 

jsalmum は 、 テー ブル を 参照 し て , ASCII コー ド (整数 値 ) の 分 類 を 行 な 
う マ クロ で す 。 判 定 の 結果 が 真 で あれ ば 0 以外 の 数 値 を 、 偽 で あれ ば 0 を 返 
し ます 。isalnum は 、 isascii(c) が 真 の 場合 、 ま た は c が EOF の 場合 に つ 


いて の み 定 義 さ れ て いま す 。 


isalnum は 、c が 英字 (4 オーク, gz) また は 数 字 (0-9) の 場合 に , 0 以 
外 の 値 を 返し ます 。 


jsalnum は UNIX シス テム て 使用 で きま す 。 
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た ニー ニー ニニ ーー ニー ニニ ーー ニー ニー ニー ニー ニー ニニ ーー ニー ピー| 
isalpha 


機能 文字 が 英字 で ある か どう か を 判定 し ます 。 


形式 #include <ctype.h> 
int isalpha (int c) : 


プロ ト タ イ プ ctypeh 


解説 jsalpha は , テー ブル を 参照 し て 、ASCII コー ド (整数 値 ) の 分 類 を 行なう 
マク ロ で す 。 判 定 の 結果 が 真 で あれ ば 0 以外 の 数 値 を , 偽 で あれ ば 0 を 返し 
ます 。 jsalpha は 、 jsascii(c) が 真 の 場合 .、 また は c が EOF の 場合 に つい て 


の み 定 義 き れ て いま す 。 
戻り 値 isalpha は c が 英字 (オー 2 一 >) の 場合 に , 0 以外 の 値 を 返し ます 。 
可 搬性 isalpha は UNIX シス テム て 使用 で きま す 。 
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isascii 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


234 


文字 が ASCII 文字 で ある か どう か を 判定 し ます 。 


#include <ctype.h> 
int isascii(int c) ・ 


ctype.h 

isascii は 、 テー ブル を 参照 し て , ASCII コー ド (整数 値 ) の 分 類 を 行なう 
マク ロ で す 。 判 定 の 結果 が 真 で あれ ば 0 以外 の 数 値 を 、 偽 で あれ ば 0 を 返し 
ます 。 

isascii は 、 すべ て の 整数 値 に 対し て 定義 &8 れ て いま す 。 


isascii は 、c が 0 一 127 (0x00 一 Ox7F) の 範囲 内 に ある 場合 に 、 0 以外 の 値 を 
返し ます 。 


isascii は UNIX シス テム で 使用 で きま す 。 
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機能 デパ ペイ スタ イプ を チェ ッ ク し ま 。 
形式 int isatty(int gzg/e) : 
プロ ト タ イ プ joh 


解説 isatty は 、Agzde が 。 次 に 示す キャ ラク タデ バイ ス の いずれ か で ある か ど 
うか の 判定 を 行ない ます 。 


男 林 

圏 コ ン ソ ー ル 
田 プ リン タ 

一 シリ アル ポー ト 


戻り 値 な sg は 、 デバイス が キャ ラク タデ バイ ス の 場合 に 0 以外 の 値 を 返し , それ 
以外 は 0 を 返し ます 。 
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iscntrl 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬 性 


236 


文字 が 制御 文字 か どう か を 判定 し ます 。 


#include <ctype.h> 


int iscntrl(int c) : 

ctype.h 

iscntrl は 、 テー ブル を 参照 し て 、 ASCII コー ド (整数 値 ) の 分 類 を 行なう 
マク ロ で す 。 判 定 の 結果 が 真 で あれ ば 0 以外 の 数 値 を 偽 で あれ ば 0 を 返し 
ます 。 jscntrl は 、isascii(c) が 真 の 場合 、 ま た は c が EOF の 場合 に つい て 
の み 定 義 る 8 れ て いま す 。 


iscntrl は 、c が 削除 文字 (Ox7F) ある い は 通常 の 制御 文字 (0x00 一 OxIF) 
の 場合 に , 0 以外 の 値 を 返し ます 。 


jscntrl は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 
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isdigit 


機能 文字 が 数 字 か どう か を 判定 し ます 。 
形式 #include <ctype.h> 
int isdigit(int c) : 


プロ ト タ イ プ ctypeh 


解脱 jsdigit は 、 テー プル を 参照 し て 、 ASCII コー ド (整数 値 ) の 分 類 を 行なう 
マク ロ で す 。 判 定 の 結果 が 真 で あれ ば 0 以外 の 数 値 を 、 偽 で あれ ば 0 を 返し 
ます 。 jadigit は isascii(c) が 真 の 場合 ,、 ま た は c が EOF の 場合 に つい て 


の み 定 義 き 8 れ て いま す 。 
戻り 値 isdigit は 、c が 数 字 (0-9) の 場合 に 、 0 以外 の 値 を 返し ます 。 
可 搬性 isdigit は UNIX シス テム で 使用 で き 、 ANSI C と 互換 性 が あ り ます 。 
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isgraph 


機能 文字 が プリ ント 可能 文字 か どう か を 判定 し ます 。 


形式 #include <ctype.h> 
int isgraph(int c) : 


プロ ト タ イ プ ctypeh 


解説 isgraph は ,、 テー ブル を 参照 し て , ASCII コー ド (整数 値 ) の 分 類 を 行 な 
う マ クロ で す 。 判 定 の 結果 が 真 で あれ ば 0 以外 の 数 値 を 偽 で あれ ば 0 を 返 
し ます 。 isgraph は , isascii(c) が 真 の 場合 ,。 また は c が EOF の 場合 に つい 


て の み 定 義 S8 れ て いま す 。 

戻り 値 isgraph は ,c が 空白 以外 の プリ ント 可能 な 文字 の 場合 に , 0 以外 の 値 を 返 
じき ま 95 

可 搬性 jsgraph は , UNIX シス テム て 使用 てき, ANSI C と 互換 性 が あり ます 。 
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islower 


機能 文字 が 英 小文字 か どう か を 判定 し ます 。 


形式 #include <ctype.h> 


int islowr(int c) : 
プロ ト タ イ プ ctype.h 


解説 jslower は 、 テー ブル を 参照 し て ,、 ASCII コー ド (整数 値 ) の 分 類 を 行なう 
マク ロ で す 。 判 定 の 結果 が 真 で あれ ば 0 以外 の 数 値 を , 偽 で あれ ば 0 を 返し 
ます 。 jslower は , isascii(c) が 真 の 場合 ,、 ま た は c が EOF の 場合 に つい て 


の み 定 義 &8 れ て いま す 。 
戻り 値 jslower は 、c が 小文字 (2 一 z) の 場合 に , 0 以外 の 値 を 返し ます 。 
可 搬性 islower は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。K& 


R で も 定義 きれ て いま す 。 
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isprint 

機能 文字 が プリ ント 可能 文字 か どう か を 判定 し ます 。 

形式 #include <ctype.h> 
int isprint(int c) : 

プロ ト タ イ プ ctypeh 

解説 jsprint は 、 テー ブル を 参照 し て , ASCII コー ド (整数 値 ) の 分 類 を 行なう 
マク ロ で す 。 判 定 の 結果 が 真 で あれ ば 0 以外 の 数 値 を 、 偽 で あれ ば 0 を 返し 
ます 。 isprint は , isaseii(c) が 真 の 場合 、 ま た は c が EOF の 場合 に つい て 
の み 定 義 き 8 れ て いま す 。 

戻り 値 isprimt は 、c が プリ ント 可能 な 文字 (0x20 一 0x7E) の 場合 に 、 0 以外 の 値 
を 返し ます 。 

可 搬性 japrint は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 

240 


第 2 章 Turbo C ラ イプ ラリ 


ーー 
ispunct 


機能 文字 が 区 切り 文字 か どう か を 判定 し ます 。 


形式 #include <ctype.h> 


int ispunct(int c) : 


プロ ト タ イ プ ctypeh 


解説 ispunct は ,、 テー ブル を 参照 し て , ASCII コー ド (整数 値 ) の 分 類 を 行なう 
マク ロ で す 。 判 定 の 結果 が 真 で あれ ば 0 以外 の 数 値 を , 偽 で あれ ば 0 を 返し 
ます 。 iapunct は , isascii(c) が 真 の 場合 、 ま た は c が EOF の 場合 に つい て 


の み 定 義 き 8 れ て いま す 。 

戻り 値 ispunct は 、c が 区 切り 文字 の 場合 (iscntrl or isspace) に , 0 以外 の 値 を 
返し ます 。 

可 搬性 iapunct は 、UNIX シス テム て で 使用 で き 、 ANSI C と 互換 性 が あり ます 。 
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1SsDace 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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文字 が 空白 文字 か どう か を 判定 し ます 。 


#include <ctype.h> 


int isspace(int c) : 

ctype.h 

isspace は 、 テー ブル を 参照 し て ,、 ASCII コー ド (整数 値 ) の 分 類 を 行なう 
マク ロ で す 。 判 定 の 結果 が 真 で あれ ば 0 以外 の 数 値 を 、 偽 で あれ ば 0 を 返し 
ます 。 isspace は , isascii(c) が 真 の 場合 、 ま た は c が EOF の 場合 に つい て 


の み 定 義 き 8 れ て いま す 。 


isspace は 、c が , 空白 、 タ プ , 復帰 、 改 行 、 垂 直 タ プ , フォ ー ム フィ ー ド 
の 場合 に , 0 以外 の 値 を 返し ます 。 


isspace は UNIX シス テム で 使用 で き 、 ANSIC と 互換 性 が あり ます 。 K& 
R で も 定義 きれ て いま す 。 
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ーーーーーーーー ニ ーーー ニーーー ニー ーー ーー ニー ニーーーー 
iSuDper 


機能 文字 が 英 大 文字 か どう か を 判定 し ます 。 


形式 #include <ctype.h> 
int isupper(int c) : 


プロ ト タ イ プ ctype.h 

解説 jsupper は 、 テー ブル を 参照 し て , ASCII コー ド (整数 値 ) の 分 類 を 行なう 
マク ロ で す 。 判 定 の 結果 が 真 で あれ ば 0 以外 の 数 値 を , 偽 で あれ ば 0 を 返し 
ます 。 isupper は , isascii(c) が 真 の 場合 ,、 ま た は c が EOF の 場合 に つい て 


の み 定 義 き 8 れ て いま す 。 

戻り 値 isupper は 、c が 英 大 文字 (オー) の 場合 に 、0 以 外 の 値 を 返し ます 。 

可 搬性 isupper は UNIX シス テム て 使用 で き , ANSIC と 互換 性 が あり ます 。K& 
R で も 定義 され て いま す 。 
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isxdigit 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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文字 が 16 進 数 の 表記 文字 か どう か を 判定 し ます 。 


#include <ctype.h> 
int isxdight(int c) : 


ctype.h 

isxdigit は 、 テー ブル を 参照 し て , ASCII コー ド (整数 値 ) の 分 類 を 行なう 
マク ロ で す 。 判 定 の 結果 が 真 で あれ ば 0 以外 の 数 値 を , 偽 で あれ ば 0 を 返し 
ます 。 iaxdigit は , isascii(c) が 真 の 場合 ,、 ま た は c が EOF の 場合 に つい て 
の み 定 義 S8 れ て いま す 。 


jsxdigit は , c が 16 進 数 の 表記 文字 (0 一 9、4ー、g- ア ) の 場合 に , 0 以 
外 の 値 を 返し ます 。 


isxdigit は 、UNIX シス テム て で 使用 で き , ANSI C と 互換 性 が あ り ます 。 


委 さ 章 Turbo (ニュ ー ニ リ 


機能 整数 を 文字 列 に 変換 し ます 。 
形式 char * itoa(int yg/ge, char * sg, int 7ggix) : 
プロ ト タ イ プ stdlib.h 


解説 itoa は , 整数 値 we の 値 を メル で 終わ る 文字 列 に 卒 換 し , 結果 を yyag に 
代入 し ます 。 
72dr に は 、 vgke を 変換 する 際 に 使用 する 基底 を 指定 し ます 。/ggkx は , 
2 一 36 の 値 で な けれ ば な り ま せん 。 yg/ke が 負 で 7ggix が 10 で ある と , Sg 
の 最初 の 文字 は 負 待 号 (-) に な り ま す 。 


注意 : sug 用 に 確保 する 領域 は , 返さ れる 文字 列 を 格納 する の に 充分 な 
大 き さ で な けれ ば な り ま せん 。 itoa の 最大 長 は , 最後 の ヌ ル 文 字 も 含め て 


17 文 字 で す 。 
戻り 値 itoa は , 文字 列 へ の ポイ ンタ を 返し ます 。 エ ラー の 戻り 値 は あり ませ ん 。 
関連 項目 ltoa, ultoa 
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kbhit 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


246 


キー ボード が 押さ れ た か どう か を チェ ッ ク し ます 。 
int kbhit (void) : 
conio.h 


kbhit は , 現在 まで に キー ポー ド が 押さ れ た か どう か の チェ ッ ク を 行ない 
ます 。 押 され た キー は , getch また は getche で 得る こと が で きま す 。 


キー ボー ド が 押さ れ て いれ ば , kbhit は 0 以外 の 値 を 返し , 押さ きれ て いな け 
れ ば 0 を 返し ます 。 


getch, getche 
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keep 


機能 プロ グラ ム を 常駐 させ た まま 終了 し ます 。 

形式 void keep (unsigned char srgzs, unsigned sze) : 

プロ ト タ イ プ dos.h 

解説 keep は , sgzs を 終了 ステ ー タ ス と し て DOS に 戻り ます 。 この と き , プロ 
グラ ム は メモ リ に 常駐 し た まま に な り ま す 。 プ ログ ラム の 大 き さ は sze パ 
ラグ ラフ に セッ ト さ れ , 残り の メモ リ は 開放 され ます 。 
keep は 、TSR プロ グラ ム を イン スト ー ル する と き に 使用 する こと が で き 
ます 。keep は , DOS ファ ンク ショ ン 0x31 を 使用 し ます 。 

戻り 値 あり ませ ん 。 


可 搬 性 KEEP は MS-DOS に 特有 の 関数 で す 。 


関連 項目 abort, exit 
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機能 long の 絶対 値 を 与え ます 。 


形式 #include <math.h> 
long int labs(long int x) : 


プロ ト タ イ プ math.h, stdlib.h 


解説 labs は , long 型 の 引数 * の 絶対 値 を 返し ます 。 
戻り 値 labs は , * の 絶対 値 を 返し ます 。 エ ラー の 戻り 値 は あり ませ ん 。 
可 搬性 labs は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


関連 項目 abs, cabs, fabs 
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ldexp 


機能 * メ 27% を 計算 し ます 。 


形式 #include <math.h> 
double Idexp(double *, int exp) : 


プロ ト タ イ プ math.h 


解説 ldexp は xX2“ や を double で 計算 し ます 。 


戻り 値 Idexp は 、xX2%% の 値 を 返し ます 。 
1Idexp の エラ ー 処 理 は 、 matherr を 通し て 変更 する こと が で きま す 。 


可 搬性 Idexp は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 


関連 項目 exp, frexp, modf 
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プロ ト タ イ プ 


解説 


250 


2 つの long の 除算 を 行ない , 商 と 剰余 を 返し ます 。 


#include <stdlib.h> 


ldiv t Idiv(long int zzer, long int dezoyz) : 
stdlib.h 


Idiv は 、2 つ の long の 除算 を 行なっ て , 商 と 剰余 を 7 型 で 返し ます 。 
zer が 被 除 数 、 eo7z が 除 数 で す 。/Zy 7 型 は long か ら な る 構造 体 で , 
stdlib.h 中 で 次 の よ うに typedef 宣言 され て いま す 。 


typedef struct ( 


1ong quoti が 商 。 */ 
1ong remi /* 剰余 */ 
) 1div ti 


1div は , gzor ( 商 ) と 7e (剰余 ) を 要素 に 持つ 構造 体 を 返し ます 。 
ldiv は ANSI C と 互換 性 が あり ます 。 
div 
nc1ude <std1ib.h> 
1div_t 1xi 
main() 
{ 
1x = 1div(100000L, 30000L): 


PrintE("100000 diy 30000 = Z1d remainder 71d\n", 
1x.quot。 1xrem): 
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機能 線形 探索 を 行ない ます 。 


形式 #include <stdlib.h> 
Yoid * Ifind(const void * ん ey, const void * 2gse, 
Size t 米 72, Size t wi の が 


int (*※ 7c7p) (const void *※、const void *)) : 


プロ ト タ イ プ stdlibjh 


解説 lfind は 、 シー ケン シャ ルレ コー ド の 配列 内 で , Key の 値 に よっ て 線形 探索 
を 行ない ます 。 探 索 に は , ユー ザ 定 義 の 比較 ルー チン (cp) が 使わ れ ま 
う 。 


探索 の 対象 と な る 配列 は 、 レ コー ド 長 が wiZ4 バ イト, レコ ュー ド 数 が 

* 472 で 、 の gse が 指す アド レス か ら 始 まる も の と し て 定義 され ます 。 

7 を yp は , ユー ザ が 定義 する 比較 ルー チン を 指す ポイ ンタ で す 。 比較 ルー チ 
ン は , ez:7 と eez2 の 2 つの 引数 を と り ます 。2 つ の 引数 は それ ぞ れ 比較 さ 
れる 値 を 指し ます 。 比較 関数 は , 2 つの 引数 が 指す 項目 (* ee/, * eey2) 
を 比較 し , その 結果 に し た が っ て 整数 値 を 返し ます 。 

* 7 の は 次 の よう な 値 を 返さ な けれ ば な り ま せん 。 


回 * eez27 リー * eez2 の 場合 、 0 以外 
田 * ep:/ ニニ * eez72 の 場合 0 


通常 は , ee7 は 引数 ey で , efeyz2 は 検索 の 対象 と な る テー プル 内 の 項目 
を 指し ます 。/zzp が 検索 キー や テー プル の 項目 を どの よう に 解釈 する か は 
自由 で あり , ユー ザ が 必要 と する 方 法 で 定義 する こと が で きま す 。 


戻り 値 1find は , 配列 内 で 検索 キー と 一 致し た 最初 の 項目 の アド レス を 返し ます 。 
一 致す る 項目 が な か っ た 場合 に は NULL を 返し ます 。 


関連 項目 bsearch. lsearch 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 一 


localtime 
機能 日 付 お よび 時 刻 を 構造 体 に 変換 し ます 。 
形式 #include <time.h> 
struct tm * localtime (const time t *※ ey) 
プロ ト タ イ プ timeh 
解説 localtime は , time が 返し た 値 の アド レス を 引数 に と り , 分 解 さ れ た 時 刻 
が 入っ て いる 構造 体 を 指す ポイ ンタ を 返し ます 。 localtime は , 地方 時 間 和 帯 
の 時 刻 を 返し , 夏時間 の 場合 に は これ も 考慮 し ます 。 
long 型 の グロ ー バ ル 変 数 gzezoze は 、 GMT と その 地方 の 標準 時 の 差 を 
秒 単位 で 保持 し て いま す (PSTー 大 平 洋 標準 時 の 場合 に は 8X60X60)。 グ 
ロー バル 変数 ggg/gf は , 夏時間 の 期間 中 に の み 0 以 外 の 値 を と る よう に 
な っ て いま す 。 
構造 体 tm は , time.h の 中 で 以下 の よう に 定義 され て いま す 。 
struct tm ( 
1nt tm seci 
1nt tm 1edsti 
}j 
これ ら は , 24 時 間 制 の 時 刻 。 日 (1 一 31)。 月 011), 曜日 (日 曜 が 0), 
年 の 下 2 桁 (年 -1900), 年 内 で の 日 (0 一 365), 夏時間 か どう か の フラ グ ( 夏 
時 間 の 間 は 0 以外 の 値 ) を 示し て いま す 。 
戻り 値 localtime は , 時 刻 が 分 解 さ れ て 入っ て いる 構造 体 を 指す ポイ ンタ を 返し 
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ます 。 こ の 構造 体 は 静 的 デー タ で , 呼び 出し が 行なわ れる ご と に 上 書き さ 
れ ま す 。 
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可 搬性 localtime は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 
関連 項目 asctime, ctime, ftime, gmtime, stime、 time, tzset 


例 ncude <stdio.h> 
お nc1ude <etd1ib.h> 
tnc1ude <time.h> 


main() 


{ 
struct tm *timeptr: 
time t secsnowi 


timezone = 8*60* 60: 

time(&secsnow) : 

timeptr = 1oca1time(&secsnow) : 

printf("The date is zd-zd-19Z02d\n* 。 
((timeptr -> tm _mon) + 1), time -> tm mday, 
timeptr -> tm year)i 

Printf("Loca1 tlme is Z02d:Z02diZ02d\n" 。 
timeptr -> hour, timeptr -> tm min。 
timeptr -> tm sec)s 


プロ グラ ム 出 力 


The date is 2-2-88 
Loca1 time is 12:44:36 
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lock 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬 性 


関連 項目 
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ファ イル シェ アリ ング の ロッ ク を セッ ト し ます 。 

int lock(int ze, long o77Se/, long /eg7 が ) : 

ioh 

lock は 、 DOS 3.* ャ の ファ イル シェ アリ ング 機構 へ の イン ター フェ ー ス を 
提供 し ます 。 

lock は , ファ イル の 任意 の 重なり の な い 領域 に 対し て 実行 する こと が で き 
ます 。 ロッ ク さ れ た 領域 に 対し て 読み 書き する プロ グラ ム は , 3 回 まで その 
操作 を 再 試行 し ます 。 3 回 と も 失敗 し た 場合 は 、 そ の 呼び 出し は エラ ー で 終 
わる こと に な り ま す 。 


lock は , 成功 し た 場合 は 0 を 返し 、 エ ラー の 場合 は -1 を 返し ます 。 


lock は MS-DOS 3.0 に 特有 の 関数 で , それ より 前 の バー ジョ ン で は 動作 し 
ませ ん 。 


open, sopen, unlock 
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log 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 


自然 対数 を 計算 し ます 。 


#include <math.h> 
double log(double *) : 


math.h 
log は * の 自然 対数 を 計算 し ます 。 
log は , 成功 し た 場合 は 計算 結果 を 返し ます 。 
引数 * が 0 以下 で あっ た 場合 は , log は HUGE_VAL を 返し , errzo に 次 の 
値 を セッ ト し ます 。 
EDOM 定義 域 エ ラー 
log の エラ ー 処 理 は , matherr 関数 を 通し て 変更 する こと が で きま す 。 


log は UNIX シス テム て 使用 で てき, ANSI C と 互換 性 が あり ます 。 


exp, log10, sqrt 
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log10 
機能 常用 対数 を 計算 し ます 。 
形式 #include <math.h> 
double log10(double *) : 
プロ ト タ イ プ mathh 
解説 log10 は 、 * の 常用 対数 を 計算 し ます 。 
戻り 値 log10 は , 成功 し た 場合 は 計算 結果 を 返し ます 。 
引数 * が 0 以下 で あっ た 場合 は , log10 は HUGE VAL を 返し , ezyzo に 次 
の 値 を セッ ト し ます 。 
EDOM 定義 域 エ ラー 
log10 の エラ ー 処 理 は , matherr 関数 を 通し て 変更 する こと が で きま す 。 
可 搬 性 log10 は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 
関連 項目 exp, log 
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プロ ト タ イ プ 


戻り 値 


ロー カル で な い goto を 行ない ます 。 


#include <setimp.h> 
void longjmp(Gmp _buf の int 7eryg/) : 


setjmp.h 


longjmp を 呼び 出す と 、 罰 p の 5 を 引数 と する setjmp の 前 回 の 呼び 出し で と 
ら え られ た タス ク の 状 胡 が 回 復 され ます 。 そし て , setimp が 値 eyg/ を 返 
し た か の よう に リタ ー ン し ます 。 

タス ク の 状態 と は 以下 の も の を いい ます 。 


一 すべ て の セグ メン トレ ジス タ (CS、DS, ES, SS) 
較 レ ジス クタ 変数 (SI DI) 

圏 ス タッ クボ イン タ (SP) 

田 フ レー ム ポ イン タ (FP) 

較 フ ラグ 


タス ク の 状態 は 、 コ ルー チン を 実現 する た め に setjmp と longjmp が 使用 
され る の に 充分 な も の で す 。 

seimp は 、 longjmp より 前 に 呼び 出し て お か な けれ ば な り ませ ん 。setjmp 
を 呼ん で 用 を 設定 し た ルー チン は 、1longjmp が 呼び 出さ れる まで は ア 
クティ プ な まま で な けれ ば な ら ず , リタ ー ン する こと は で き ませ ん 。 もし, 
そう し て し まっ た 場合 は 、 結果 は 子 測 で きま せん 。 

これ ら の ルー チン は , プログ ラム の 低 レ ベル サ プ ル ー チ ン に お いて 起こ る 
エラ ー や 例外 を 処理 する 際 に 便利 な も の で す 。 

longjmp は 値 0 を 返す こと は で きま せん 。7epyg/ に 0 を 入れ て 渡す と , longj- 
mp は これ を 1 に 置き 換え ます 。 


あり ませ ん 。 
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可 搬性 longjump は UNIX シス テム て 使用 で き 、 ANSIC と 互換 性 が あり ます 。 


関連 項目 setjmp, signal 


例 ncude <stdio.h> 
nc1ude <setjmp.hz 


jnp_buf jumperi 


main() 
{ 
int valuei 


Yalue = setjmp( jumper) 

if (value != 0) 

6 
printf(*Longjmp with value zdwn', value): 
exit(value): 

} 

printf("About to ca11 subroutine ... \m')i 

subroutine( ): 

} 


subroutine( ) 
{ 
1ongjmp( jumper,1): 


プロ グラ ム 出 力 


About to ca11 subroutine ..・ 
Longjnp with value 1 
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機能 unsigned long の 値 を 左 ヘ ロー テー ト し ます 。 


形式 unsigned long lrotl(unsigned long yg/, int cozz/) : 


プロ ト タ イ プ stdlib.h 


解説 _-Irotl は , 与え られ た 値 yg7 を , 指定 され た ビッ ト 数 cowz7 だ け 左 へ ロー テ 
ー ト し ます 。 yg/ は unsigned long で す 。 


戻り 値 _lrotl は 、 yg/ を cozf ビッ ト 左 ヘ ロ ー テ ー ト し た 値 を 返し ます 。 
関連 項目 _lrotr, rotl 
例 _rotl を 参照 し て くだ さい 。 
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機能 unsigned long の 値 を 右 へ ロー テー ト し ます 。 
形式 unsigned long lrotr(unsigned long yg/, int cozz7) : 
プロ ト タ イ プ stdlibh 


解説 _Irotr は 、 与え られ た 値 vg/ を 指定 され た ビッ ト 数 cowzf だ け 右 へ ロー テ 
ー ト し ます 。 yg/ は unsigned long で す 。 


戻り 値 _lrotr は , yg/ を couz7 ビッ ト 右 へ ロー テー ト し た 値 を 返し ます 。 
関連 項目 _lrotl, rotr 
例 _rotl を 参照 し て くだ さい 。 
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ーーーーーーーーーーーーーーーーーーーーーーー、 ハハ 


lsearch 


機能 線形 探索 を 行ない ます 。 


形式 #include <stdlib.h> 
Void * lsearch(const void * ey, void * 02se, 
Size t 米 4/2。Size t wi が 
int (* 7p) (const void *、const void 玉 )) : 


プロ ト タ イ プ stdlibh 


解説 lsearch は ,、 テー ブル 中 の 情報 を 検索 し ます 。 lsearch は 線型 探索 を 行なう 
の で 呼び 出し の 前 に テー プル が ソー ト され て いる 必要 は あり ませ ん 。 ん ey 
が 指し て いる 項目 が テー プル の 中 に 存在 し な い 場合 , lsearch は その 項目 
を テー プル に 追加 し ます 。 


還 225e は , 検索 する テー プル の 基底 (0 番目 の 要素 ) を 指し ます 。 
一 zz は 、 テー ブル 内 の 要 楽 の 個数 を 示す 数 値 を 指し ます 。 

還 2 は 1 つの 項目 の 大 き さ (バイ ト 数 ) を 示し ます 。 
較 ん ey は , 検索 する 項目 (検索 キー) を 指し ます 。 


7 を 2p は , ユー ザ が 定義 する 比較 ルー チン を 指す ポイ ン タタ で す 。 比較 ルー チ 
ン は 2 つの 引数 (ex/, eei2) を と り , この 引数 は それ ぞ れ 比 較 され る 値 
を 指し ます 。 比較 関 数 は , 2 つの 引数 が 指す 項目 (* @ezz7。 *※ ee2) を 
比較 し , その 結果 に し た が っ て 整数 値 を 返し ます 。 通 常 は 。 eyy7 は 引数 
ん ey で , ez2 は 検索 の 対象 と な る テー プル 内 の 項目 を 指し ます 。/zgp 
は , 次 の よう な 値 を 返す 必要 が あり ます 。 


較 * ez7/ ニニ ー* eezz2 の 場合 ,0 
団 ez7 一 * e/ezz2 の 場合 。 0 以外 の 値 


た Zp が 検索 キー や テー プル の 項目 を どの よう に 解釈 する か は 自由 で あり , 
ユー ザ が 必要 と する 方 法 で 定義 むす る こと が で きま す 。 
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戻り 値 


可 搬性 


関連 項目 


例 
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]search は , テー ブル 内 て 検索 キー と 一 致し た 最初 の 項目 の アド レス を 返 
し ます 。 


lsearch は UNIX シス テム で 使用 で きま す 。 


bsearch, lfind, qsort 


# す nclude <stdio-.h> 
#1nclude <std1ib.h> 
す 1nc1ude <string.h>  /* strcmp の 宣言 の た め */ 


/* カラ ー の 番号 を 初期 化 */ 
char *co1ors[10] = ( "Red",。 "Blue", "Green' ): 
1nt ncolors = 3 ぉ 


1nt co1orscmp(char **arg1。 Char **arg2) 
6 

return(strcmp(*arg1。 *arg2)): 
} 


1nt addelem(char *color) 
( 
int oldn = ncolorSi 
1search(&color, colors。 (sze t *) &ncolore。 
stzeoE(char *)。 co1orscmP) 3 
return (ncolors =e ol1dn)i 


} 
main() 
{ 
いい 倒す 


char *key = "Purple'i 


1f (adde1em(key) ) 
printf("Zs already in colors table\n" 。 key): 
else 
printf("Zs added to colors table, now Zd Colors\n*。 
key, ncolors)i 
printE("The color8: ぜ nm")s 


for (は ー 1 < ncolorsi 1++) 
Printf("ZsWn" 。 colors[1]): 
} 
プロ グラ ム 出 力 


purple added to colors table, 
now 4 colors 
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機能 ファ イル ポイ ンタ を 移動 し ます 。 


形式 #include <io.h> 
long lseek (int gzd/e, /ozg o7 が Ser。 7 な 7 ozneere) : 


プロ ト タ イ プ ioh 


解説 lseek は , 2xdfe に 結び つけ られ て いる ファ イル ポイ ンタ を , oymw/ere で 
指定 され た 位置 か ら o7ser バイ ト 離 れ た 位置 に 移動 し ま す 。 万 oznZee は 。 
0, 1, 2 の いずれ か で な けれ ば な り ませ ん 。 oeye に は , stdio.h の 中 で 
定義 され て いる 次 の 3 つの シン ポリ ッ ク 定 数 を 用 いる と 便利 で す 。 


ーーーーーーーーーーーーーーーーーーーーー 


ozye7e ファ イル の 位置 


SEEK_ SET (0) ファ イル の 先頭 
SEEK CUR (1) ファ イル ポイ ンタ の 現在 位置 
SEEK END (2) ファ イル の 終わ り 


ーーーーーーーーーーーーーーーーーー 


戻り 値 lseek は , ポイ ンタ の 新しい 位置 の オフ セッ ト を , ファ イル の 先頭 か ら の バ 
イト 数 で 返し ます 。 エ ラー の 場合 は -1L を 返し , eryo は 次 の いずれ か に セ 
ッ ト さ れ ま す 。 


EBADF ファ イル 番号 が 正しく な い 
EINVAL 正しく な いり 引数 


シー ク が 行 な を を な い デ バイス (端末 や プリ ンタ ) に 対し て は , 戻り 値 は 未 
定義 で す 。 


可 搬性 lseek は UNIX シス テム て 使用 で きま す 。 
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関連 項目 filelength, fseek, ftell, sopen, write, write 
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機能 long 型 を 文字 列 に 変換 し ます 。 


形式 #include <stdlib.h> 


char * ltoa(long yg/we, char * szg, int 7ggx) : 


プロ ト タ イ プ stdiibjh 


解説 ltoa は 、 vg/e の 値 を メル で 終わ る 文字 列 に 変換 し , 結果 を siag に 格納 し 
ます 。 
72x に は ug/ge を 変換 する 際 に 使用 する 基底 を 指定 し ます 。7ggrx は ,。 
2 一 36 の 値 で な けれ ば な り ま せん 。 yg/e が 負 で 7ggix が 10 で ある と , 文字 
列 の 最初 の 文字 は 負 符 号 (-) に な り ま す 。 


注意 : yyzg 用 に 確保 する 領域 は 、 返 され る 文字 列 を 格納 する の に 充分 な 
大 きき で な けれ ば な り ませ ん 。Itoa が 返す 最大 文字 数 は , 最後 の ヌ ル 文 字 
(\0) も 含め て 33 文 字 で す 。 


戻り 値 3 つの 関数 と も 文字 列 へ の ポイ ンタ を 返し ます 。 エ ラー の 戻り 値 は あり ませ 
ん 。 


関連 項目 itoa, ultoa 
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malloc 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 
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メイ ン メ モリ を 割り 当て ます 。 


#include <stdlib.h〉 or #include <alloc.h> 


void * malloc(size t sEe) : 


stdlibh。 alloc.h 


malloc は ,C の メモ リヒ ー プ か ら sze バイ ト の プロ ッ ク を 確保 し ます 。 こ 
れ に よっ て , プログ ラム は 、 必要 な と き に 必要 な 量 だ け メ モリ を 確保 する 
こと が で きま す 。 

ヒー プ は , 可変 サイ ズ の メモ リプ ロッ ク の 動 的 割り 当て に 使用 され ます 。 

木 構造 や リス ト と いっ た 多く の デー タ 構 造 は 通常 ヒー プ メ モリ に 割り 当 
て られ ます 。 

スモ ー ル デー タモ デル で は , デー タ セ グ メ ント の 終わ りか ら プ ログ ラム ス 
タッ ク の 先頭 まで の すべ て の 領域 を ヒー プ と し て 使用 する こと が で きま す 
た だ し , スタ ッ ク ト ッ プ の 直前 の 256 バ イト は , アプ リケーション 用 の スタ 
ッ ク の 拡張 領域 と DOS が 使用 する 領域 と し て 確保 され て いる た め 除 外さ 
れ ま す 。 

ラー ジ デ ー タ モデ ル で は , プロ グラ ム ス タ ッ ク を 越え て メモ リ の 物理 的 な 
最終 位置 まで の すべ て の 領域 が ヒー プ と し て 使用 可能 で す 。 


malloc は , sze に 指定 し た 長 さ の メモ リプ ロッ ク を 指す ポイ ンタ を 返し ま 
す 。 要求 し た プロ ッ ク を 確保 する だ け の メモ リ が 充分 な 場合, malloc は 
NULL を 返し , プ ブロッ ク の 内 容 は その まま に な り ま す 。 

引数 szge ニ =0 の 場合 に は NULL を 返し ます 。 

malloc は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


allocmem, calloc, coreleft, farcalloc, farmalloc, free, realloc 
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例 #1nc1ude <stdio.h> 
#1nc1ude <etd1ib.h> 


typedef struct ( 
ECJ/ 
) 0BJECT: 


0BJECT *NewObject() 
( 

return ((OBJECT *) ma1loc(sizeoF(0BJECY) ) ) : 
} 


Void FreeObject(0BJECT *ob]) 
{ 

free(ob}): 
} 


main() 
{ 
0BJECT *ob]: 


ob] = NewObject()』 

1f (obj == NULL) ( 
Printf("fai1ed to create a new objectn*): 
exit(1)j 

} 

7 ーー・ */ 

free(ob}) 
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_matherr 


機能 


形式 


プロ ト タ イ プ 


解説 
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浮動 小数 点 エ ラー を 処理 し ます 。 


#include <math.h> 
double matherr( mexcep w/y,char * 7 が 。 
double * grg/p, double * grg2p, double 7eyg/) : 


mathh 


_matherr は 、 す べ て の 数 学 ラ イプ ラリ 関数 内 の エラ ー 処 理 に お いて 中 心 
的 に 機能 する 関数 で す 。 matherr は , matherr を 呼び 出し て , matherr 
が 返す 値 を 処理 し ます 。 matherr は . ユー ザ プ ロ グラ ム か ら 直 接 呼び 出す 
こと は で きま せん 。 数 学 ラ イプ ラリ の エラ ー 処 理 は matherr 関数 を 置き 
換え る こと に よっ て カス タマ イズ する こと が で きま す 。 

数 学 ラ イプ ラリ ルー チン の いずれ か で エラ ー が 起こ る と , いく つか の 引数 
と と も に _matherr が 呼び 出さ れ ま す 。 matherr は 次 の 4 つの 処理 を 行 な 
いま す 。 


田 流 され た 引数 で exceptiomn 構造 体 を 埋め ます 。 

一 exception 構造 体 を 指す ポイ ンタ e を 引数 と し て matherr を 呼び 出 
し , matherr が その エラ ー を 解決 で きる か どう か を 調べ ます 。 

男 matherr か ら の 戻り 値 を 調べ て 、 次 の 処理 を 行ない ます 。 
matherr が 0 を 返し た (matherr が その エラ ー を 解決 で き な か っ た ) 
場合 、 matherr は errzo を セッ ト し て エラ ー メ ッ セ ー ジ を 出力 し ま 
すす 3 
matherr が 0 で な い 値 を 返し た (matherr が その エラ ー を 解決 で きた ) 
場合 は 、_matherr は 何 ち し ませ ん 。 

田 も と の 呼び 出し 側 へ , e->7eryg7 を 返し ます 。 matherr は 、 e->/eyg7 
を , も と の 呼び 出し 側 へ 返し た い 値 に 変更 で きる こと に 注意 し て くだ 
さい 。 
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_matherr が eryzo を セッ ト す る 場合 (matherr か ら の 戻り 値 が 0), 起こ 
っ た エラ ー の 種類 (exception 構造 体 の pg フィー ルド) を errzo ( 値 は 
EDOM か ERANGE) に 入れ る こと に な り ま す 。 


戻り 値 _matherr は 、e->/eryg7 の 値 を 返し ます 。 この 値 は , 初め は _matherr に 渡 
され た 引数 eyg7 の 値 で あり , matherr に よっ て 変更 きれ る こと も あり ま 
す 。 
数 学 関数 の 結果 が MAXDOUBLE より 大 きか っ た 場合 、 デ フォ ルト で は 
eyg7 は _matherr に 渡さ れる 前 に 、HUGE_VAL に 適切 な 符号 を つけ た 
も の に セッ ト さ れ ま す 。 数 学 関数 の 結果 が MINDOUBLE より 小さ か っ た 
場合 は zewg7 は 0 に セッ ト され , matherr に 渡さ れ ま す 。 ど ちら の 場合 
で も , matherr が e->7eryg7 の 値 を 変換 し な い 場 合 は , matherr が eryzo 
に ERANGE (結果 が 範囲 外 ) を セッ ト し ます 。 


関連 項目 matherr 
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matherr 


機能 ユー ザ が 変更 可能 な 数 学 エ ラー ハン ドラ で す 。 


形式 #include <math.h> 


int matherr (struct exception *※ e) : 


プロ ト タ イ プ mathh 


解説 matherr は 数学 ラ イプ ラリ が 生成 し た エラ ー を 処理 する た め に math- 
err ルー チン に よっ て 呼び 出さ れ ま す 。 
matherr は 、 ユー ザ 独 自 の 数 学 エラ ー 処 理 ル ー チ ン か 必要 な 場合 に 、 こ れ 
を 置き 換え て 使用 する フッ ク と し て 提供 され て いま す ( 後 で 示す 例 を 参照 
し て くだ さい )。 
matherr は , 数 学 関数 が 引き 起こ し た 定義 域 エ ラー お よび 値 域 エラ ー を ト 
ラッ プ す る の に 便利 で す 。 ゼ ロ に よる 除算 な どの 浮動 小数 点 の 例外 を トラ 
ッ プ する こと は で きま せん 。 こ うし た エラ ー の トラ ッ プ に つい て は sigmnal 
を 参照 し て くだ さい 。 
matherr を , 独自 の エラ ー 処 理 ル ー チ ン (ある タイ プ の エラ ー を 提 え て 解 
決する ) と し て 定義 する こと が で きま す 。 修 正 し た matherr は 、 エ ラー を 
解決 で き な か っ た 場合 に は 0, 解決 で きた 場合 に は 0 で な い 値 を 返さ な けれ 
ば な り ま せん 。matherr が 0 で な い 値 を 返し た と き は , エラ ー メ ッ セ ー ジ は 
プリ ント さき れず, eryzo は 変更 きれ ませ ん 。 
exception 構造 体 は 、math.h の 中 で 次 の よう に 定義 され て いま す 。 


struct exception ( 

1nt typei 

char 。 *namei 

doub1e arg1, ar&g2, retva1: 
} 
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exception 構造 体 の メン バ は 次 の よう に な っ て いま す 。 
ーーー ニーーー ーーーーー ーー ニニ ーー ニー ーー ーー 


メン バ 意味 

の pe 起き た 数 学 エ ラー の タイ プ 。typedef 名 excep (後述 ) 
の 中 で 定義 され た enum 型 の 値 。 

97776 エラ ー を 起こ し た 数 学 ラ イブ ラリ 関数 の 名 前 を 持つ 文字 


列 を 指す ポイ ンタ 。 
の g7, の g2 エラ ー を 起こ し た 引数 。 関 数 へ 渡さ れる 引数 が 1 つ だ け の 
場合 は gg7 に 入れ る 。 
7eryg7 その エラ ー の デフ ォ ル ト の 戻り 値 。 こ の 値 は 変更 する こ 
と が で きる 。 
ーーーーーー ーーーーー ーーー ニー ニニ ニー ニー ーー ニー ニー ニー ニー 


typedef 名 zzexcep (これ も math.h の 中 で 定義 され て いま す ) は , 次 に 示 
すそ れ ぞ れ の 数 学 エラ ー に 対応 する シン ポリ ッ ク 定 数 を 定義 し て いま す 。 

ーーーーーーーーーーー フ ーー 
シン ボリ ッ ク 定 数 数 学 エラ ー 


DOMAIN 関数 の 領域 に 引数 が 入っ て いな い 。 例 : log(-1)。 
SING 引数 が 特異 性 を 引き 起こ す 。 例 : pow (0,-2)。 
OVERFLOW 引数 の た め , 関数 の 結果 が MAXDOUBLE を 越え る 。 
例 : exp(1000)。 
UNDERFLOW 引数 の た め , 関数 の 結果 が MINDOUBLE を 下回る 。 
例 : exp(-1000)。 
TLOSS 引数 の た め , 関数 の 結果 の 有効 数 字 が 減る 。 
例 : sin(10e70)。 
ーーーーーーーーーーーーー ニ ーー ーー ニニ ーー ニー 


シン ポリ ッ ク 定 数 MAXDOUBLE, MINDOUBLE は values.h の 中 で 定義 
され て いま す 。 

_matherr を 変更 する こと は で き な い こと に 注意 し て くだ さい 。matherr 
は , 多く の C ラ ンタ イム ライ プラ リ に 含ま れ て お り , matherr を 使用 すれ 
ば 可 搬 性 を 高め る こと が で きま す 。 
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戻り 値 


可 搬 性 


関連 項目 
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UNIX スタ イル の matherr の デフ ォ ル ト の 動作 (メッ セー ジ を プリ ント 
し て 終了 する ) は , ANSI と の 互換 性 は あり ませ ん 。UNIX スタ イル を 望 
む の で あれ ば , Turbo C の マス ター ディ スク に 含ま れ て いる matherr.c を 
使用 し て くだ さい 。 


matherr の デフ ォ ル ト の 戻り 値 は 、 エ ラー が UNDERFLOW ある い は 
TLOSS の 場合 に は 1, それ 以外 の 場合 に は 0 で す 。matherr は , e->7eyg/ 
を 変更 する こと も で きま す 。 変 更 し た 値 は , matherr を 経由 し て も と の 呼 
び 出 し 側 に 返さ れる こと に な り ま す 。 

matherr が 0 を 返し た (エラ ー を 解決 する こと が で き な か っ た ) 場合 は 。 
_matherr が er7zzo を セッ ト し て エラ ー メ ッ キ ー ジ を 出力 し ます (_math- 
err を 参照 し て くだ さい )。 

matherr が 0 で な い 値 を 返し た (エラ ー を 解決 する こと が で きか ) 場合 は , 
e77740 は セッ ト さ れず 。 メッ セー ジ も 出力 され ませ ん 。 


matherr は 、 多 く の C コン バイ ラ て 使用 で きま す が , ANSI と の 互換 性 は 
あり ませ ん 。 

メッ セー ジ を プリ ント し て 終了 する UNIX スタ イル の mmatherr は , 
Turbo C の マス ター ディ スク に 含ま れ て いる MATHERR.C で 提供 され 
て いま す 。 


_matherr 


/* これ は ユー ザ 定 義 の matherr 関 数 で 。 sqrt に 負 の 引数 が 濾 さ れ た 場合 に 
sqrt が その 値 を 処理 する 前 に 負 で な い 数 値 に 変換 し ます . 7/ 


nclude <math.h> 
nc1ude <etring.h> 


1nt matherr(struct exceptton *a): 
( 
1f (a -> type == DOMATN) 
{ 
1f(strcmp(a -> name。 "8qrt") == 0) 
9 
a -> retval = sqrt (-(a -> arg1)): 
return (1) ぉ 
} 
} 
return (0)i 
} 
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ImaX 


機能 2 つの 値 の 大 きい 方 を 返し ます 。 
形式 #include <stdlib.h> 
(type) max(g, の ) : 


プロ ト タ イ プ stdlibh 


解説 max は , 2 つの 値 を 比較 し て 大 きい 方 を 返す マク ロ で す 。 2 つの 引数 と 関数 
の 型 は 同じ も の と し て 闘 言 さ まれ な けれ ば な り ま せん 。 


戻り 値 max は , 大 きい 方 の 値 を 返し ます 。 
関連 項目 min 
例 す Hnc1ude <etd1ib.h> 
main() 
6 
nt x = 5i 
ntyー6: 
nt zi 


2 = (nt) max(x, て ): 
PrintE("The 1arger number 1e zdwn*。z): 


プロ グラ ム 出 力 


The 1arger number is 6 
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memccDy 


機能 


形式 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬性 


関連 項目 
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メモ リプ ロッ ク を コピ ー し ます 。 


#include <mem.h> 


void * memccpy(void * des, const void * ye,int c, size t ) : 
string.h, mem.h 


memccpy は 、ye から の es7 へ カバ イト の プロ ッ ク を コピ ー を し ます 。 コピ 
ーー は, 次 の 条件 の いずれ か が 満た され る と 終了 し ます 。 


罰 文 字 c が ges7 に 初め て コピ ー さ れ た 。 
圏 2 バ イト が の es7/ に コピ ー さ れ た 。 


memccpy は 、c が コピ ー さ れ た 場合 は es 中 の c の 次 の バイ ト を 指す ポ 
イン タ を 返し 、 そう でない 場 合 は NULL を 返し ます 。 


memccpy は UNIX シス テム V て 使用 で きま す 。 


memcpy, memmmove, memset 


第 2 章 Turbo C ラ イプ ラリ 


memchr 


機能 メモ リプ ロッ ク 中 て 文字 を 検索 し ます 。 


形式 #include <mem.h> 


Void * memchr(const void * sint c, sizet の) : 


プロ ト タ イ プ string.h, mem.h 


解説 memchr は ,、 ゞ が 指し て いる メモ リプ ロッ ク の 最初 の み バ イト の 中 で , 文 
字 c を 探し ます 。 
戻り 値 memechr は , s の 中 で 最初 に c が 見 つか っ た 位置 を 指す ポイ ンタ を 返し ま 


す 。 見 つか ら な けれ ば NULL を 返し ます 。 


可 搬性 memchr は UNIX シス テム V て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 
TnermCrmD 


機能 2 つの メモ リプ ロッ ク を 比較 し ます 。 


形式 #include <mem.h> 


Yoid * memcmp(const void * s/, const void * s2, size t の ) : 
プロ ト タ イ プ string.h, mem.h 


解説 mememp は 、 57 と 32 が 指す 2 つの プロ ッ ク の 先頭 か ら ヵ カバ イト を, 各 バ イ 
ト を unsigned char と し て 比較 し ます 。 


戻り 値 mememp は , 次 の よう な 値 を 返し ます 。 
<0 37 が 3s2 より 小さ い 場 合 
0 37 と 52 が 等 し い 場合 


<0 37 が s2 より 大 きい 場合 


各 バ イト は unsigned char と し て 比較 され る の で , 次 の 式 は 正 の 値 を 返し 
ます 。 


memcmp( "PF "7P*。1) 
可 搬性 mememp は UNIX シス テム V で 使用 で き , ANSI C と 互換 性 が あり ます 。 


関連 項目 memicmp 
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ーーーー ーー ニー ニー ニニ ニニ ニー ーー ュ ホ 二 一 . 
memcpy 


機能 メモ リプ ロッ ク を コピ ー し ます 。 


形式 #include <mem.h> 


Yoid * memcpy(void * des, const void * ye, sizet ヵ ) : 


プロ ト タ イ プ string.h, memh 


解説 memepy は , wc か ら de ヘ カ タバ イト の プロ ッ ク を コピ ー し ます 。 yrc と 


es が オー バー ラッ プ し て いる 場合 の 動作 は 未定 義 で す 。 


戻り 値 memecpy は es7 を 返し ます 。 
可 搬性 memcpy は UNIX シス テム V て 使用 で き , ANSI C と 互換 性 が あり まず 。 
関連 項目 memeccpy, memmove, memset, movedata, movemem 
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memicmp 


機能 2 つの メモ リプ ロッ ク を 文字 ケー ス を 無視 し て 比較 し ます 。 


形式 #include <mem.h> 


int memicmp(const void *※ s7,const void * 52, size t の ) : 
プロ ト タ イ プ string.h, mem.h 


解説 memicmp は , 57 と 5s2 が 指す 2 つの プロ ッ ク の 先頭 か ら 4 バイ ト を , 文字 
ケー ス (大 文字 か 小文字 か ) を 無視 し て 比較 し ます 。 


戻り 値 memicmp は 、 次 の よう な 値 を 返し ます 。 
<⑩0 。s7 が s2 より 小さ い 
=0 s/ と 52 が 等 し い 
<0 s7 が s2 より 大 きい 


可 搬性 memicmp は UNIX シス テム V て 使用 で きま す 。 


関連 項目 memcmp 


278 第 2 章 Turbo C ラ イブ ラリ 


ーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 
Imermimove 


機能 メモ リ 配 列 を 操作 する 


形式 #include <mem.h> 


Void * memmove(void * ges/, const void * ye, size t カ ) 


プロ ト タ イ プ string.hmem.h 


解説 memmove は 、syc か ら de ヘタ バイ ト の プロ ッ ク を コピ ー し ます 。 yrc と 
9e57 で オー バー ラッ プ し て いる 場合 で も , オー バー ラッ プ 部 分 は 正しく コ 
ピー され ます 。 

戻り 値 memmove は des/ を 返し ます 。 

可 搬 性 memmove は UNIX シス テム V て 使用 で き , ANSI C と 互換 性 が あり ま 
> 

関連 項目 memccpy, memcpy, movmem 
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memset 


機能 メモ リプ ロッ ク に 指定 され た 文字 を セッ ト し ます 。 


形式 #include <mem.h> 


Void * memset(void * ま sint c, size t カ ) : 


プロ ト タ イ プ string.h, mem.h 


解脱 memset は , ゞ が 指す プロ ッ ク の 先頭 か ら ヵ バイ ト に , 文字 c を セッ ト し ま 
す 。 

戻り 値 memset は ゞ を 返し ます 。 

可 搬性 memset は UNIX シス テム V て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 

関連 項目 memccpy, memcpy, setmem 
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機能 2 つの 値 の 小さ い 方 を 返し ます 。 
形式 #include <stdlib.h> 
(type) min(4, の : 


プロ ト タ イ プ stdlibjh 


解説 min は , 2 つの 値 を 比較 し て 小さ い 方 を 返す サマ クロ で す 。2 つ の 引数 と 関数 
の 型 は , 同じ も の と し て 宣言 され な けれ ば な り ま せん 。 


戻り 値 min は , 小さ い 方 の 値 を 返し ます 。 


関連 項目 max 


例 nc1ude <std1ib.h> 
main() 
int x = 5: 
nt y = 6 
nt zi 


< = (nt) min(x。y)』 
Prntf("The sma11er number is zdwnr, う 衣 


プロ グラ ム 出 力 


The smal11er number is 5 
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mkdir 


機能 ディ レク トリ を 作成 し ます 。 


形式 #include <dos.h> 
int mkdir(const char * pg77) ・ 


プロ ト タ イ プ dirh 


解説 mkdir は , pg に 指定 され た パス 名 か ら , ディ レク トリ を 新た に 作成 し ま 
す 。 
戻り 値 mkdir は , 新しい ディ レク トリ が 作成 で きた 場合 0 を 返し ます 。 


戻り 値 -1 は エラ ー を 意味 し , errzo に 次 の いずれ か 値 が セッ ト され ます 。 


EACCESS アク セス は 否定 され た 
ENOENT その よう な ファ イル また は ディ レク トリ は な い 


関連 項目 chdir, getcurdir, getcwd, rmdir 
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MK FP 


機能 far ポイ ンタ を 作り ます 。 


形式 #include <dos.h> 
void far * MK _FP(unsigned seg, unsigned o が 5) ・ 


プロ ト タ イ プ dosh 


解説 MIK FP は 、 セグ メン ト (seg) と オフ セッ ト (os) か ら far ポイ ンタ を 作 
り 出 す マ クロ で す 。 
戻り 値 MIK FP は far ポイ ンタ を 返し ます 。 


関連 項目 FP_OFF.FP SEG, movedata, segread 


例 FP_OFF を 参照 し て くだ さい 
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mktemp 


機能 ユニ ー ク な ファ イル 名 を 作り ます 。 
形式 char * mktemp(char * /e7zp/2e) : 


プロ ト タ イ プ dirh 


解説 mktemp は , /ezp/g7e が 指す 文字 列 を テニ ー ク な ファ イル 名 で 置き 換え 
て , 7eyp/g7e を 返し ます 。 
7e7p/2fe は 、 "6 個 か ら な り , ヌル で 終わ る 文字 列 で な けれ ば な り ませ ん 。 
6 個 の ※ は , ユニ ー ク な 英字 と 1 個 の ピリ オド に 置き 換え られ ます 。2 個 の 英 
字 , ビリ オド , 3 個 の 英字 に な る わけ で す 。 
新しい ファ イル 名 は , AA.AAA か ら 始 め て , ディ スク 上 の ファ イル の 名 前 
を 見 て , 同じ 名 前 に な ら な いよ うに 選ば れ ま す 。 


戻り 値 re7p/zfe が うま く 得 られ た 場合 は , mktemp は 文字 列 ep/ge の アド レス 
を 返し ます 。 そ う で な い 場 合 は NULL を 返し ます 。 


可 搬性 mktemp は UNIX シス テム て 使用 で きま す 。 
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機能 浮動 小数 点数 を 整数 部 と 小数 部 に 分 割 し ます 。 


形式 #include <math.h> 
double modf(double *, double * pg7) : 


プロ ト タ イ プ mathh 


解説 modf は , double 型 の x を 2 つの 部 分 (整数 部 と 小数 部 ) に 分 割 し ます 。 pgr 
が 指す 場所 に 整数 部 を 格納 し , 小数 部 を 関数 値 と し て 返し ます 。 


戻り 値 modf は 、 ェ の 小数 部 を 返し ます 。 


関連 項目 fmod, Idexp 
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movedata 


機能 


形式 


プロ ト タ イ プ 


286 


バイ ト を コピ ー し ます 。 


void movedata (unsigned srcseg, unsigned srco/, unsigned の s/seg, 
unsigned so が , size t カ ) ・ 


mem.h,string.h 


movedata は 、 ア ドレ ス yeseg : syco7 か ら ヵ カバ イト を , の seg : の 7o が 7 に 
コピ ビー し ます 。 
movedata は 、 メ モリ モデ ル に 依存 し な い デ ー タ ブロック の 転送 手段 で す 。 


あり ませ ん 。 
FP_OFF, memcpy, MK _FP. movmem, segread 


#1nclude <mem.h> 
#define RED PLANE OxA800 
char buf[80*400]: 


/* グラ フィ ッ ク VRAM の 赤 の プレ ー ン を buffer に セー プ す る */ 
Void save_red_p1ane(char near *buEEer) 
{ 


movedata(RED PLANE, 0, DS, (unsigned) buEfer, 80*400)j 
} 


main() 
6 
save_red plane(buf): 


} 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


ImOVmnel 


機能 メモ リプ ブロ ッ ク を 指定 の 長き だ け コ ピー し ます 。 

形式 void moemem(void * syc, void *※ の es7, unsigned /ezg7) ・ 

プロ ト タ イ プ memh 

解説 movmem は , ezg 太 バイ ト の プロ ッ ク を 、 sc か ら des7 へ コピ ー し ます 。 
2 つの プロ ッ ク が オー バー ラッ プ し て いる 場合 は , 正 し く コ ピー され る よう 
に コピ ー の 方 向 が 選ば れ ま す 。 


戻り 値 あり ませ ん 。 


関連 項目 memcpy, memmove, movedata 
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ーー ニー ーー ニー ニー ニニ ーー ニー ニー ニーー、 三 -。 一 
nosound 


機能 PC-9801 : ダミ ー 関 数 。 
IBM PC : スピ ー カ を 止め ます 。 


形式 Yoid nosoud (void) : 


プロ ト タ イ プ dos.h 


解説 PC-9801 で は , mosound は 何 の 動作 も し な い ダ ミー 関数 と し て 定義 され て 
いま す 。 
IBM PC で は 、 nosound は ,sounmd の 呼び 出し に よっ て 鳴っ て いる スピ ー 
カ を 止め ます 。 

戻り 値 あり ませ ん 。 


関連 項目 delay, sound(IBM PC) 
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_Open 


機能 


形式 


プロ ト タ イ プ 


ファ イル を 読み 出し また は 書き 込み 用 に オー プン し ます 。 


#include <fcntl.h> 


int open(const char * ezgzze, int の 77ggs) : 
io.h 


_open は , ezg7e に 指定 され た ファ イル を オー プン し , og77ggs の 値 に し た 
が っ て 読み 出し , 書き 込み 、 ある い は 両用 と し て 準備 を 行ない ます 。 フ ァ 
イル は , グロ ー バ ル 変 数 7 ヵ zode に 指定 され て いる モー ド で オー プン され 
ます 。 

の 7ggs の 値 は , DOS 2.* の 下 で は ,O_RDONLY,O_WRONLY,O_RDWR 
の いずれ か に 限定 され ます 。 DOS 3.* で は ,、 さら に 以下 の 値 を 指定 する こ 
と が で きま す 。 


O_NOINHERIT その ファ イル を 子 プ ロ セ ス に 引き 継が な いと き に 指 
定 する 。 

O_DENYALL 現在 の ハン ドル だ けが その ファ イル に アク セス で き 
る 。 

O_DENYWRITE その ファ イル に 対す る 読み 出し 用 オー プン の み を 許 
す 。 

O_DENYREAD その ファ イル に 対す る 書き 込み 用 オー プン の み を 許 
す 。 

O_DENYNONE その ファ イル に 対す る 他 の シェ アド オー プン を 許す 。 


これ ら の 0 ..… シ ン ポ リッ ク 定 数 は fcntl.h の 中 で 定義 され て いま す 。 
DOS 3.* の 下 で は 、 1 つの _open に 対し て , O_DENYxxx 値 の うち , 1 つ だ 
けが 指定 で きま す 。 こ れ ら の ファ イル シェ アリ ング 属性 は 、 ファ イル の ロ 
ッ ク 機 能 に 加え て 用 意 き され て いま す 。 同時 に オー プン で きる ファ イル 数 の 
上 限 は ,、 シ ステ ム の コン フィ ギュ レー ショ ン パ ラメ ー タ (CONFIG.SYS フ 
ァイル 中 の FILES の 値 ) に な っ て いま す 。 
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戻り 値 成功 する と , open は 負 で な い 整 数 (ファ イル ハン ドル ) を 返し ます 。 フ 
ァイル 中 の 現在 位置 を 示す ファ イル ポイ ンタ は , ファ イル の 先頭 に セッ ト 
され ます 。 エ ラー の 場合 は -1 を 返し , erzzzo に 次 の いずれ か の 値 を セッ ト 
し ます 。 


ENOENT パス 名 また は ファ イル 名 が 見 つか ら な か っ た 
EMFILE オー プン され て いる ファ イル が 多 すぎ る 
EACCESS アク セス が 否定 され て いる 

EINVACC アク セス コー ド が 正しく な い 


可 搬性 _open は MS-DOS に 特有 の 関数 で す 。 


関連 項目 open, read, sopen 


290 第 2 章 Turbo C ラ イブ ラリ 


open 


機能 ファ イル を 読み 出し また は 書き 込み 用 に オー プン し ます 。 


形式 #include <fcntl.h> 
#include <sys\stat.h> 
int open(const char * pg7 太 int gccess [, unsigned 7zoge] ) : 


プロ ト タ イ プ ioh 


解説 open は , pg 太 に 指定 され た ファ イル を オー プン し , gccess の 値 に し た が っ 
て , 読み 出し , 書き 込み 、 あ る い は 両用 と し て 準備 を 行ない ます 。 
gccess に 指定 する 値 は 、 次 に 示す 2 つの リス ト の フラ グ を ビッ ト ご と に OR 
する こと に よっ て 作ら れ ま す 。 リ スト 1 か ら は 1 つの フラ グ し か 選べ ませ ん 。 
リス ト 2 か ら は , 複数 の フラ グ を 組み 合わ せる こと が で きま す 。 


リス ト 1 : 読み 出し / 書 き 込み フラ グ 
O_RDONLY 読み 出し 専用 と し て オー プン 
O_WRONLY 書き 込み 専用 と し て オー プン 


O_RDWR 読み 出し お よび 書き 込み 用 と し て オー プン 


リス ト 2 : 他 の アク セス フラ グ 


O_NDELAY 使用 きれ ませ ん 。UNIX と の コン パチ ビリ ティ を 図る 
た め の も の で す 。 

O_APPEND これ が セッ ト さ れ て いる と , ファ イル ポイ ンタ は まず 
ファ イル の 終わ り に 位置 づけ られ ます 。 

O_CREAT 指定 の ファ イル が すでに 存在 し て いれ ば , この フラ グ 
は 意味 を 持ち ませ ん 。 存在 し て いな けれ ば , ファ イル 
は 新規 作成 され 、 oe の ビッ ト が chmod の 場合 と 同 
様 に し て ,、 属性 ビッ ト に セッ ト さ れ ま す 。 

O_TRUNC ファ イル が 存在 し て いる 場合 は 、 そ の 長 さ は 0 に 削ら れ 
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ます 。 フ ァイル 属性 は その まま て 変化 し ませ ん 。 

O EXCL 使用 きれ ませ ん 。UNIX と の コン パチ ビリ ティ を 図る 
た め の も の で す 。 

O_BINARY この フラ グ は , 明示 的 に バイ ナリ モー ド で ファ イル を 
オー プン する こと を 示す の に 使用 きれ ます 。 

O_TEXT この フラ グ は , 明示 的 に テキ スト モー ド で ファ イル を 
オー プン する こと を 示す の に 使用 され ます 。 


これ ら の シン ポリ ッ ク 定 数 は 、 fcntl.h の 中 で 定義 8 され て いま す 。 
O_BINARY も 0_TEXT も 与え られ て いな い 場 合 は , ファ イル は , グロ ー 
バル 変数 7 が zode に セッ ト さ れ て いる 変換 モー ド で オー プン され ます 。 
特定 の モー ド で ファ イル を 新た に 作成 する に は , その モー ド 値 を zoge 
に 代入 し て お く か , O_CREAT お よび O_TRUNC と 要求 する モー ド の 
OR を と っ た も の を open の 引数 gccess と し て 与え る 必要 が あり ます 。 た 
と えば 次 の 呼び 出し は , 


open(*xmp', O_CREATIO_TRUNCIO_BTNARY。S_TREAD) 


ファ イル XMP を , バイ ナリ モー ド で 読み 出し 専用 で 作成 し ます 。XMP が 
すでに 存在 し て いる 場合 は 、 フ ァイル サイ ズ を 0 バイ ト に し ます 。 
O_CREAT フラ グ が oge を 作る の に 使わ れる と , オプ ショ ン の 引数 per- 
5 を 次 に 示す シン ポリ ッ ク 定 数 か ら 作 る こと に な り ま す 。 


77o9e の 値 アク セス 許可 
S_IWRITE 書き 込み 可 
S_IREAD 読み 出し 可 


S_IREAD | SIWRITE 読み 書き 可 
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戻り 値 成功 する と , open は 負 で な い 整 数 (ファ イル ハン ドル ) を 返し ます 。 フ ァ 
イル の 現在 位置 を 示す ファ イル ポイ ンタ は , ファ イル の 先頭 に 位置 づけ ら 
れ ま す 。 エ ラー の 場合 は -1 を 返し , errzo に 交 の いずれ か の 値 を セッ ト し 
ます 。 


ENOENT パス 名 また は ファ イル 名 が 見 つか ら な か っ た 
EMFILE オー プン され て いる ファ イル が 多 す ぎる 
EACCESS アク セス が 拒否 され た 

EINVACC アク セス コー ド が 正しく な い 


可 搬 性 open は UNIX シス テム で 使用 可能 で す 。 UNIX バー ジョ ン 7 で は 、 O_ 型 の 
ニー モニ ッ ク は 定義 8 され て いま せん 。 UNIX シス テム IL は , O_BINARY 
を 除く すべ て の O _ 型 ニー モニ ッ ク を 使用 し て いま す 。 


関連 項目 chmod, chsize, close, creat, creatmew, creattemp, dup, dup2, 


fdopen, filelength, fopen, freopen, getftime, lock, open, 
read, sopen, write 
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outport 


機能 ハー ドウ ェ ア ポ ー ト に 1 ワー ド 出 力 し ます 。 


形式 void outport(int porgZ,int vg/we) ・ 


プロ ト タ イ プ dosh 


解説 outport は , por77 に 指定 され た 出力 ポー ト へ , yg/ke に 与え られ た ワー ド 
を 出力 し ます 。 

戻り 値 あり ませ ん 。 

可 搬 性 outport は 80x86 フ ァ ミ リィ に 特有 の 関数 で す 。 

関連 項目 inport, inportb, outportb 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


outportb 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 


ハー ドウ ェ ア ポ ー ト に 1 バイ ト 出 力 し ます 。 


#include <dos.h> 
void outportb(int porZ, unsigned char yg/e) : 


dos.h 


outportb は , porZ に 指定 され た 出力 ポー ト へ 、 yg/e に 指定 され た バイ ト 
を 出力 する マク ロ で す 。 

outportb は , dos.h が イン クル ー ド され て いる 場合 は 、 インライン コー ド 
に 展開 され る マク ロ と し て 扱わ れ ま す 。 

dos.h を イン クル ー ド し て いな い 場 合 や 、 イ ンク ルー ド し て いて も マク ロ 
outportb を #undef し て いる 場合 は 、 関数 と し て 扱わ れ ま す 。 


あり ませ ん 。 


outportb は 80x86 フ ァ ミ リィ に 特有 の 関数 で す 。 


inport, inportb, outport 


Turbo C 標 準 聞 数 リフ ァ レ ンス 295 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


parsfnm 


機能 ファ イル 名 を 解析 し ます 。 


形式 #include <dos.h> 


char * parsfnm(const char * cz の ze, struct fcb * の. int op/) : 


プロ ト タ イ プ dosh 


解説 parsfmm は 、 cy が 指す 文字 列 を 解析 し て ファ イル 名 を 取り だ し ます 。 
ege は 。 通常 は コマ ンド ライ ン で す 。 フ ァイル 名 は FCB の 中 に , ドラ 
イプ , ファ イル 名 , お よび 拡張 子 と し て 配置 され ます 。 5 が FCB を 指し 
て で W ゆ ます 
引数 gp, は , DOS の 解析 シス テム コー ル 0x29 で AL に 与え る 値 で す 。 シ ス 
テム コー ル Ox29 に お ける 解析 処理 の 詳細 に つい て は , MS.DOS プロ グラ マ 
ー ズ リフ ァ レ ンス マニ ュ ア ル を 参照 し て くだ さい 。 


戻り 値 ファ イル 名 の 解析 に 成功 し た 場合 parsfmm は 、 フ ァイル 名 の 終わ り の 次 
の バイ ト を 指す ポイ ンタ を 返し ます 。 エ ラー が 起こ っ た 場合 は 0 を 返し ま 
す 。 

可 搬性 parsfnm は MS-DOS に 特有 の 関数 で す 。 
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peek 


機能 指定 され た メモ リ 位 置 の ワー ド を 返し ます 。 
形式 int peek (unsigned segzen7, unSigned o/7se/) : 
プロ ト タ イ プ dosh 


解説 peek は , segzzen7 : の ser の メモ リ 位 置 に ある ワー ド を 返し ます 。 
peek は , dosjh を イン クル ー ド し て いる 場合 は 、 イン ライ ンコ ー ド に 展開 
され る マク ロ と し て 扱わ れ , dos.h を イン クル ー ド し て いな い ( あ る い は イ 
ンク ルー ド し て いて も , #undef peek と し て いる ) 場合 は , 関数 と し て 扱 


われ ます 。 

戻り 値 peek は , segyiez7 : の ser の メモ リ 位 置 に スト ア さ れ て いる ワー ド を 返し 
ます 。 

可 搬性 peek は 80x86 ア ー キ テク チャ に 特有 の 関数 で す 。 

関連 項目 harderr, peekb, poke 
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peekb 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 
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指定 され た メモ リ 位 置 の バイ ト を 返し ます 。 


#include <dos.h> 
char peekb(unsigned seg7zez7, unSsigned o77se/) : 


dosh 

peekb は , segyier : の 7 が Ser の メモ リ 位 置 に ある バイ ト を 返し ます 。 
peekb は , dos.h を イン クル ー ド し て いる 場合 は , イン ライ ンコ ー ド に 展開 
され る マク ロ と し て 扱わ れ , dos.h を イン クル ー ド し て いな い ( あ る い は イ 
ンク ルー ド し て いて も , #undef peekb と し て いる ) 場合 は , 関数 と し て 扱 
われ ます 。 


peekb は , segyen7 : の 7ser の メモ リ 位 置 に スト ア さ れ て いる バイ ト を 返し 
ます 。 


peekb は 80x86 ア ー キ テク チャ に 特有 の 関数 で す 。 


peek,pokeb 
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ーー トー 。 ーーー ニー ーーーーーーーーーーー ーー ーーーーーーーーーーーーーーーーー 


DerrOr 


プロ ト タ イ プ ブ 


解説 


戻り 値 


可 搬性 


関連 項目 


シス テム エラ ー メ ッ セ ー ジ を プリ ント し ます 。 


void perror(const char * $) ・ 


stdio.h 


perror は 、 現在 の プロ グラ ム 内 の シ ステ ムコ ー ル で 起き た 一 番 新 し い エ ラ 
ー を 示す メッ セー ジ を , スト リー ム sfder (通常 は コン ソー ル ) に 出力 し ま 
す 。 

まず 引数 s を プリ ント し , その 後に コロ ン 、 er7zo の 現在 の 値 に 対応 する 
メッ セー ジ を 続け , 最後 に 改行 を 出力 し ます 。 慣例 に し た が えば , 引数 ゞ に 
は プロ グラ ム の 名 前 を 指定 する こと に な り ま す 。 

ェ エ ラー メッセ ー ジ 文字 列 の 配列 は 、 ss_err/fef を 通し て アク セス され ま 
す 。 er77zo を 、 エラ ー 番 号 に 対応 する 文字 列 を 見 つけ 出す た め の 添字 と し 
て 使う こと が で き ます 。 文 字 列 に は 改行 文字 は 含ま れ て いま せん 。 

ss err は , 配列 内 の メッ セー ジ の 数 を 示し て いま す 。 

errzo、 8 の 5_ er77zs。 8 の 8_e77 の 詳細 に つい て は 、 第 1 章 の 「 グ ロー バル 
変数 」 を 参照 し て くだ さい 。 


あり ませ ん 。 


perror は UNIX シス テム て で 使用 で き 、 ANSI C と 互換 性 が あり ます 。 


clearerr, eof, strerror, StrerrOr 
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poke 

機能 指定 の メモ リ 位 置 に 整数 値 を 格納 し ます 。 

形式 void poke(unsigned segzzez7, unsigned o77se7, int vg/we) : 

プロ ト タ イ プ dos.h 

解説 poke は , seg7ie7 : の 77se7 の メモ リ 位 置 に , 整数 値 g/we を 格納 し ます 。 
poke は , dos.h を イン クル ー ド し て いる 場合 に は ,、 イ ン ラ イン コー ド に 展 
開 さ れる マク ロ と し て 扱わ れ ま す 。dos.Jh が イン クル ー ド され て いな い ( あ 
る い は イン クル ー ド され て いて も 、#undef poke と し て いる ) 場合 は , マ 
クロ で は な く 関 数 と し て 扱わ れ ま す 。 

戻り 値 あり ませ ん 。 

可 搬性 poke は 80x86 フ ァ ミ リィ に 特有 の 関数 で す 。 

関連 項目 harderr, peek, pokeb 
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pokeb 


機能 指定 の メモ リ 位 置 に バイ ト 値 を 格納 し ます 。 


形式 #include <dos.h> 
void pokeb (unsigned seg7zez7, unSigned o77se/, char yg/ze) ・ 


プロ ト タ イ プ dosh 


解説 pokeb は , segzzen7 : の 75ef の メモ リ 位 置 に 。 バイ ト 値 ge を 格納 し ま 
す 。 
pokeb は , dos.h を イン クル ー ド し て いる 場合 に は , イン ライ ンコ ー ド に 展 
開 さ れる マク ロ と し て 扱わ れ ま す 。dos.h が イン クル ー ド され て いな い ( あ 
る い は イン クル ー ド され て いて も , #undef pokeb と し て いる ) 場合 は 、 マ 
クロ で は な く 関 数 と し て 扱わ れ ます 。 


戻り 値 あり ませ ん 。 
可 搬 性 pokeb は 80x86 フ ァ ミ リィ に 特有 の 関数 で す 。 


関連 項目 peekb, poke 
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poly 
機能 多項式 の 計算 
形式 #include <math.h> 
double poly(double *, int egyee, double coe/ が な []) : 
プロ ト タ イ プ mathh 
解説 poly は , 係数 coe/ な が [0] coe/ が [1], ..… coe/s[2eg7ee]、 次 数 ggree の 
多項式 の * に お ける 値 を 計算 し ます 。 た と えば , gegzee ニ 4 の 場合 生成 さ 
れる 多項式 は 次 の よ うに な り ま す 。 
coe7 が [4]x* 十 coe7 が [3]** 十 coe7 が [2]xs 
+ coe/ な [1]* + coe が [0] 
戻り 値 poly は * に お ける 多項式 の 値 を 返し ます 。 
可 搬性 poly は UNIX シス テム で 使用 で きま す 。 
302 
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プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 


* の 了 径 を 計算 し ます 。 


#include <math.h> 
double pow(double x, double ) : 


math.h 

pow は 、** を 計算 し ます 。 

pow 関数 は 、 成功 し た 場合 、 計算 結 果 xy を 返し ます 。 

引数 の 値 に よっ て は , オー バー フロ ー が 起き た り , 計算 で き な い こと が あ 
り ます 。 計算 結果 が オー バー フロ ー に な る 場合 、 pow は HUGE_VAL を 返 
し ます 。 大 き さ が 非常 に 大 きい 結果 の 場合 は eryzo に 次 の 値 を セッ ト し ま 
す 。 


ERANGE 値 域 エ ラー 


引数 * が 0 以下 で , か つ 了 が 整数 で な か っ た 場合 に は , er7zo は 次 の 値 に セ 
ッ ト さ れ ま す 。 


EDOM 定義 域 エ ラー 


引数 * と が と も に 0 で あっ た 場合 に は 、 pow は 1 を 返し ます 。 
pow の エラ ー 処 理 は , matherr 関数 を 使っ て 変更 する こと が で きま す 。 


pow は UNIX シス テム で 使用 で き 、 ANSI C と 互換 性 が あり ます 。 


exp, pow10, sqrt 
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pow10 
機能 10 の ヵ 乗 を 計算 し ます 。 
形式 #include <math.h> 
double pow10(int p) : 
プロ ト タ イ プ mathh 
解説 pow10 は , 10? を 計算 し ます 。 
戻り 値 pow10 関数 は 、 成功 し た 場合 は 計算 結果 10? を 返し ます 。 
千 果 は 内 部 で は long double で 計算 され ます 。 こ の た め 有 効 な 引数 で あっ 
て も , アン ダー フロ ー ま た は オー バー フロ ー が 起き る こと が あり ます 。 
可 搬性 pow10 は UNIX シス テム て 使用 で きま す 。 
関連 項目 exp, Dow 
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printf 


機能 書式 つき 出力 を srdoz7 に 書き 出し ます 。 
形式 int printf(const char * /or7ig7 [、 gg が 7 …] ) ・ 
プロ ト タ イ プ stdiojh 


解説 printf は , /6g7 に よっ て 指 さ れ る 書式 文字 列 中 の 書式 指定 を , /oryg7 の 
後に 続く 各 引 数 に 適用 し , 書式 化 さ れ た デー タ を siowf に 出力 し ます 。 書 
式 指定 は , 後に 続く 引数 と 同じ 数 だ け な け れ ば な り ま せん 。 


書式 文字 列 : 

書式 文字 列 は printf 関数 に 含ま れ て いま す が , これ は 関数 が どの よう に 
引数 を 変換 、 書式 化 , プ リン ト す る か を 指定 する も の で す 。 書 式 文字 列 
に 対し て 充分 な 数 の 引数 が 必要 で す 。 引 数 が た りな い 場 合 は , 結果 は 子 
測 で き な い も の に な り ま す 。 引 数 が 多 すぎ る 場合 は 、 単に 無視 され る だ 
け で す 。 

書式 文字 列 に は , 2 種類 の オプ ジェ クト が 含ま れ て いま す 。 通常 の 文字 と 
変換 指定 で す 。 


一通 常 の 文字 は 単に 出力 スト リー ム に 1 文字 ずつ 送ら れ ま す 。 
画 変 換 指定 は 、 引数 リス ト か ら 引 数 を 取り 出し , 書式 化 を 行ない ます 。 
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変換 指定 : 
printf の 書式 文字 列 は 次 の よう な 形式 を ちっ て いま す 。 


[フラグ 〕 [印字 幅 ] 〔- 生 度 ] [FINIhiHIL] 型 


各 変換 指定 は % で 始ま り ます 。% に 続い て 、 以下 に 示す も の が , この 順 
で 現われ ます 。 


圏 オ プシ ョ ン の フラ ク グ 文 字 の 並び 
田 オ プシ ョ ン の 印 季 幅 指定 子 

較 オ プシ ョ ング の 精度 指定 子 

一 オ プシ ョ ン の 入力 サイ ス 修 飾 子 
玉 変 換 指定 文字 


書式 文字 列 の オプ ショ ン の 要素 : 
書式 文字 列 に お ける オプ ショ ン の 文字 , 指定 子 , 修飾 子 に よっ て 行わ れ 
る 出力 の 書式 化 の 概要 を 示し ます 。 


文字 / 指 定子 何 を 制御 する の か , また は 何 を 指定 する の か 


フラ グ 左 詰め か 右 詰め か 、 数値 の 符号 , 小数 点 , 後に 続く ゼロ , 
8 進 /16 進 の プレ フィ クス 
印字 幅 印字 する 最小 文字 数 , 余白 を ゼロ / 空 白 ど ちら で 埋め る か 
精度 印字 する 最大 文字 数 : 整数 の 場合 は 印字 する 最小 桁 数 
サイ ズ 引数 の デフ ォ ル ト サ イ ズ を 変更 する 
(N=mear ポイ ンタ 、F ニ far ポイ ンタ 、h ニ short int, 
1= ニ long, Llong double) 
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printf の 変換 指定 文字 : 


次 の 表 に は , printf の 変換 指定 文字 許さ れる 引数 の 型 , の 書式 が 示さ 


れ て いま す 。 


表 中 の 情報 は 。 書式 指定 に は , フラ ク 文 字 、 印 字 幅 指定 , 精度 指定 , 入 
力 サ イズ 指定 が 含ま れ て いな いと 仮定 し た 場合 に 基づい て いま す 。 オ プ 
ショ ン の 文字 お よび 指定 子 が どの よう な 影響 を 与え を る か に つい て は ,、 こ 


の 後 の 表 を 参照 し て くだ さい 。 


ーーーーーーーーーーーーーーーーーーーーーーーーー 


型 指定 文字 入力 引数 出力 の 書式 
数 値 
d 整数 符号 つき 10 進 整数 
i 整数 符号 つき 10 進 整数 
o 整数 符号 な し 8 進 整 数 
u 整数 符号 な し 10 進 整数 
に 整数 符号 な し 16 進 整数 (g, か .c,9,e/ を 使用 ) 
ト 整数 符号 な し 16 進 整数 (4.8,C, の 万 た を 使 


f 党 動 小数 点数 
e 浮動 小数 点数 


g 浮動 小数 点数 


E 浮動 小数 点 


G 浮動 小数 点 


用 ) 

符号 つき の [-] gggZg 形式 の 値 
符号 つき の [-]Zgggge [ 十 /-] 47 形式 
の 値 

符号 つき の e また は ア 形式 の 値 、 ど ちら 
に な る か は 与え られ た 値 と 精度 に よっ て 
決ま る 。 後に 続く ゼロ お よび 小数 点 は 必 
要 な 場合 に だ け 印 字 き れる 。 

e と 同じ 、 指数 部 を 示す 記号 は と に な 
る 。 

g と 同じ , e 形 式 が 使用 きれ る と きけ は 指 
数 部 を 示す 記号 は と に な る 。 
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308 


文字 


は 文字 一 個 の 文字 。 

8 文字 列 ポ イン タ ヌル 文字 に 出会う か , 精度 に 達する ま 
で 文字 を プリ ント する 。 

% な し 文字 % が プリ ント され る 。 

ポイ ンタ 

n 整数 ポイ ンタ これ まで 書か れ た 文字 の 数 を (入力 引 
数 に よっ て 指 さ れ た 場所 に ) 格納 する 。 

p ポイ ンタ 入力 引数 を ポイ ンタ と し て 印字 する 。 


far ポイ ンタ は XXXX : YYYY、 
near ポイ ンタ は YYYY (オフ セッ ト 
だ け ) と 印字 され る 。 
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慣例 : 


これ ら の 指定 子 の いく つか に 関し て は 次 に 示す よう な 慣例 が あり ます 。 


文字 


企 例 


eE 


gG 


3 


引数 は [-]Zd み .…e[ 十 /-] ggg 形式 に 変換 され る 。 

・ 小 数 点 の 前 に は 数 字 が 1 桁 だ け 置 か れる 

・ 小 数 点 の 後に は 「 精 度 」 桁 の 数 字 が 置か れる 

・ 指 数 部 は 常に 3 桁 
引数 は 10 進 で [-]4Z4g.. 形 式 に 変換 され , 小数 点 の 後 の 桁 数 
は 精度 と 等 し く な る (精度 が 0 で な いと き )。 
引数 は e. 戸 び の いずれ か の 形式 で 印字 され る 。 精 度 が 有効 数 字 
の 桁 数 を 決め る 。 後続 の 0 は 省略 され , 小数 点 は 必要 な と き に の 
みつ けら れる 。 
変換 指定 文 定 が g の 場合 は 、 e また は ア 形式 で 印字 され る 。 で 
の 場合 は 形式 で 印字 され る 。 変換 の 結果 得 ら れる 指数 部 が 次 
の 場合 に は e 形式 が 使わ れる 。 

(a) 精度 より 大 きい 

(b) 一 4 より 小さ きい 

ェ 変換 で は , 文字 か.c,,e/ が 出力 中 に 現われ , 変換 で は 
4 で, の, が 現われ る 。 


注意 : 浮動 小数 点数 の 無限 値 は , INF ある い は 一 INF と し て プリ ント 
され ます 。 ま た , IEEE の 非 数 (Not-aーNumber) は , 二 NAN ある い 
は 一 NAN と し て プリ ント され ます 。 


Turbo C 標 準 関数 リフ ァ レ ンス 309 


フラ グ 文 字 : 
フラ グ と し て 使用 され る 文字 は ,-, 十 , 空白 で す 。 こ れ ら は 組み 合わ 
せ て 指定 で きま す 。 


フラ グ 何 を 指定 する か 


や 結果 を 左 詰め で 印字 する 。 つ まり 右側 に 空白 を 埋め 込む 。 こ の 指 
定 が な いと 結果 は 右 詰め で 印字 され る 。 つ まり , 左側 に ゼロ また 
は 空白 を 埋め 込む 。 

+ 符号 つき 変換 の 結果 は , 常に 十 か ー の 符号 が つけ られ て プリ ント 
され る 。 

空白 、 値 が 負 で な い 場 合 は 、 正 符号 を つけ ず に 空白 で 始ま る 。 負 の 場合 
は 負 符 号 で 始ま る 。 

# 引数 が 変 砺 形式 を 用 いて 変換 され る こと を 指定 し ます 。 次 の 表 を 
参照 


注意 : 十 と 空白 が 両方 指定 され て いる 場合 は 十 が 優先 し ます 。 
交替 形式 : 


# が 変換 文字 と と も に 使用 され た 場合 は , 変換 され る 引数 に 対し て 次 の よ 
うな 効果 を も ち ま す 。 


変換 文字 # が どん な 影響 を 与え る か 


esduiu 影響 な し 
o 0 で な い 引 数 の 場合 、 そ の 前 に 0 が つけ られ る 。 
XX Ox (また は OX) が 引数 の 前 に つく 。 
ewE,f 出力 に は , その 後に 数 字 が な く て も 常に 小数 点 が 含ま れる 。 
通常 は , 後に 数 字 が ある と き に の み 小 数 点 が 置か れる 。 
gG と の 場合 と 同じ し 。 た だ し 最後 の で ロ は 省略 され る 。 
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印字 幅 指定 子 : 
印字 幅 指定 子 は , 出力 の た め の 最小 の フィ ー ル ド 幅 を セッ ト し ます 。 
印字 幅 の 指定 する 方 法 は 2 通り あり ます 。 数 字 列 を 使っ て 直接 的 に 指定 す 
る も の と , アス タリ スク (*) を 使っ て 間接 的 に 指定 する も の が あり ま 
す 。 印 字 幅 指定 子 と し て アス タリ スク を 使う 場合 , 実際 に 出力 され る 引 
数 の 前 に , 印字 幅 指定 子 を 含む 引数 (int 型 で な けれ ば な ら な い ) が 指定 
され て いな けれ ば な り ま せん 。 
印字 幅 が 小さ く て も , フィ ー ル ド が 削ら れる こと は あり ませ ん 。 変 換 の 
結果 が フィ ー ル ド 幅 より 広い 場合 は 、 フィール ド は 単に ひろ げ ば られ , 変 
換 さ れ た 結果 が 入り ます 。 


印字 幅 指定 子 出力 幅 は どの よう に な る か 


mn 少な く と も ヵ 文 字 印 字 さ れる 。 出力 値 が ヵ 文字 より 少な 
いと き は 空白 で 埋め られ る (- フ ラグ が ある 場合 は 右側 
な い 場 合 は 左側 )。 

On 少な く と も n 文 字 印 字 さ れる 。 出力 値 が n 文字 より 少な 
いと き は ゼロ で 埋め られ る (- フ ラグ が ある 場合 は 右側 。 
な い 場 合 は 左側 )。 

※ 引数 リス ト は 印字 幅 指定 子 を 含む 。 印 字 幅 指定 子 は 書式 
化 き れる 実 引数 の 前 に 置か な く て は な ら な い 。 


精度 指定 子 : 

精度 指定 子 は 常に ビリ オド (.) て 始ま り , 印字 幅 指定 子 と は 区 別 さ れ ま 
す 。 印 字 幅 の 場合 と 同様 精度 も , 数 字 列 を 使っ て 直接 ,、 あ る い は アス 
タリ スク (*) を 使っ て 間接 に 指定 する こと が で きま す 。 精 度 指定 子 に 
アス タリ スク を 使う 場合 、 実際 に 出力 され る 引数 の 前 に , 精度 指定 子 を 
含む 引数 (int 型 で を けれ ば な ら な い ) を 指定 し な けれ ば な り ま せん 。 
アス タリ スク を , 印字 幅 指定 子 と 精度 指定 子 の 両方 に 指定 し た 場合 は 
実際 に 変換 され る 引数 の 前 に 2 つの 引数 が 置か れる こと に な り ま す 。 
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精度 指定 子 出力 精度 は どの よう に な る か 


指定 な し デフ ォ ル ト の 精度 
の, 形式 1 


と ど 形式 6 
6 形式 有効 数 字 す べ て 
形式 ヌル 文字 まで プリ ント する 
c 形 式 影響 を 与え な い 
.0 9 の ,a, テ 形式 に 対し て は 精度 は デフ ォ ル ト 値 に セッ ト 
され る 。 る と ア 形式 に 対し て は 小数 点 は 出力 され な い 。 
・T ヵ 文 字 あ る い は ヵ 桁 が 印字 され る 。 出力 値 が ヵ 文 字 以 上 


の 場合 は 出力 は (変換 指定 文字 に よっ て ) 削ら れ た り 
丸め られ た りす る こと が ある 。 
に 引数 リス ト は 精度 指定 子 を 含ん で いる 。 精 度 指定 子 は 書 
式 化 さ れる 実 引数 の 前 に 置か な を く て は な ら な い 。 
= ニー ニー ニー ニニ ニョ 症 ーー ニー 
注意 : 明示 的 に 精度 0 が 指定 され , その フィ ー ル ド の 書式 指定 が 整数 形式 
(2.7.9..*) で なおかつ 印 字 さ れる 値 が 0 の 場合 に は ,。 その フィ ー ル ド 
に は 数 字 は まっ た く 出 力 さ れ ま せん (つま り そ の フィ ー ル ド は 空白 に な 
り ま す )。 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 
変換 文字 精度 指定 子 は どの よう な 影響 を 与え る か 


diouuxX な は 。 最低 n 桁 が 印字 され る こと を 指定 する 。 入 力 引数 が 
ヶ 桁 より 少な い 場 合 は , 出力 値 は 左側 が ゼロ で 埋め られ る 。 
入力 引数 が ヵ 桁 より 大 きく て も 出力 値 は 削ら ち れ な い 。 

EE み は 。 小数点 の 後に ヵ 文 字 印字 され る こと を 指定 する 。 最 
後 の 桁 は 丸め られ る 。 


gG み は , 最大 ヵ 桁 の 有効 数 字 が 印字 され る こと を 指定 する 。 
で - み は , 出力 に 関し て 何 の 影響 も 与え な い 。 
s タ は, ヵ 文字 以上 の 文字 が 印字 され な いこ と を 指定 する 。 


ーーーーーーーーーーーー ニ ーーー ニ ーーーーー ーーー ニー ニーーーーーー: 


312 第 2 章 Turbo C ラ イプ ラリ 


入力 サイ ズ 修飾 子 : 
入力 サイ ズ 修 飾 子 の 文字 (,W, ん 7. と ) は , 次 に 示す 入力 引数 の サイ ズ を 
与え ま す 。 


= far ポイ ンタ 7 = long 
near ポイ ンタ と = long double 
ん 三 short int 


入力 サイ ズ 修 飾 子 (F,W.47./) は , 対応 する 入力 引数 の デー タ 型 を .… 
printf 関数 が どの よう に 解釈 する か に 影響 を 与え ます 。 了 と パ は , ポイ 
ンタ (%p,%5,%z) の 引数 に 対し て の み 使 用 する こと が で きま す 。 ん 7 お 
よび し 上 し は, 数 値 (整数 と 浮動 小数 点数 ) の 入力 引数 に 対し て の み 適 用 で 
きま す 。 

と は と も に ., 入力 引数 を 再 解釈 する た め の も の で す 。 通常 は % ヵ ,% 
5 ヵ 変 換 に 対応 する 引数 は , 使 有 中 の メモ リモ デル の デフ ォ ル ト サ イ 
ズ の ポイ ンタ で す 。 ど は 「 入 力 引数 を far ポイ ンタ と し て 解釈 する 」, 
は 「 入 力 引 数 を near ポイ ンタ と し て 解釈 する 」 と いう 意味 で す 。 

ん 7 お よび と は と も に , 入力 数 値 デ ー タ 引数 の デフ ォ ル ト の サイ ズ を 変 
更 す る た め の も の で す 。/7 と と は 整数 (7. の 4 メダ) と 浮動 小数 点数 (e 
と げ ,g,C) の 各 形 式 に 対し て 適用 で きる の に 対し , ヵ は 整数 形式 に し か 適 
用 で きま せん 。 ん 7 お よび し は, 文字 の cs 形式 や 、 ポ イン タ の ヵ ヵ 形 
式 に は 影響 を 与え ませ ん 。 


入力 サイ ズ 修飾 子 引数 が どう 解釈 され る か 


F 引数 は far ポイ ンタ と し て 解釈 され る 。 

N 引数 は near ポイ ンタ と し て 解釈 され る 。 パ は ヒュ ー 
ジ モ デ ル で は , どん な 変換 と も 組み 合わ せ て 使う こと 
は で きま せん 。 

h の の, で は , 引数 は short int と し て 解釈 され る 『 

1 の 4 え で は , 引数 は long int と 解釈 され る 。 
と げ ,g,C で は , 引数 は double と 解釈 され る 。 

L 万 げ ,g,C で は , 引数 は long double と 解釈 され る 。 
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戻り 値 printf は 出力 し た バイ ト 数 を 返し ます 。 エ ラー の 場合 は EOF を 返し ます 。 


可 搬性 printff は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あり ます 。K& 
R で も 定義 8 れ て いま す 。 


関連 項目 cprintf, ecvt, fprintf, fread, fscanf, putc, puts, putw, 


scanf, sprintf, vprintf, vsprintf 
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例 す include <stdio.h> 
#define 1 555 
#define R 5.5 


main() て 
3 3 る 3 > 
char buE[7]i 
char *prefix = bufi 
char tp[20]i 


printf("prefix 6d 6o 8x 10.2e 10.2f\n")j 

strcpy(preflx。* え "): 

Eor (1 = 0: も エ < 2 14+) て 

for (] = 0i ] < 2 ]++) 
for (k = 0: k < 2: kt+) 
Eor (1 = 0: 1 < 2』 14+) 人 

1f (1 == 0) strcat(prefix。 
1f (] == 0) strcat(prefix。 
1f (k == 0) strcat(preflx。 
1f (1 == 0) strcat(prefix。, 
Printf("Z58 1"。 prefix)s 
strcpy(tp,。 Pref1ix)s 
strcat(tp。 "6d 17)j 
PrintE(tP, 
strcpy(tP, 
gtrcpy(tP。 
strcat(tP。 
PrintE(tp。 
strcpy(tP。 ""): 
strcpy(tp, prefix): 
strcat(tp。 "8x 1")5 
PrintE(tp, エ ): 
strcpy(tpP,。 "")5 
strcpy(tp, Prefix)i 
strcat(tp,。 "10.2e 1")1 
printf(tp,。 R)i 
strcpy(tD, preflx)s 
strcat(tp。 "10.2f 7) 
printE(tp,。 R)s 
printf(" wm")s 
Strcpy(preflx。 " え ")5 
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プロ グラ ム 出 力 


prefix ed eo 8x 10.2e 10.2E 
ィ -+#0 555 01053 『Ox22b |+5.50e+00 i+5.50 1 
アー+ チ 101053 10x22b は +5.50e+00 15.50 1 
z-10 1053 122b は 5.50e+00 は 5.50 1 
メー 1053 122b は 5.50e+00 1+5.50 H 
z-#0 101053 IOx22b 15.50e+00 15.50 1 
アー 101053 Ox22b 15.50e+00 1i5.50 ! 
z-0 1053 122b 15.50e+00 15.50 H 
- 053 122b 15.50e+00 1!5.50 1 
z+#0 1001053 10x00022b |+05.50e+00 !+000005.50 | 
27】 ! 01053 | Ox22b | +5.50e+00 1 +5.50 1 
z+0 |+00555 1001053 10000022b |+05.50e+00 !+000005.50 1 
せ | +555 ! 1053 1 22b | +5.50e+00 ! +5.50 1 
7#0 1000555 1001053 Ox00022b 1005.50e+00 10000005.50 1 
7 | 555 | 01053 | 0x22b | 5.50e+00 5.50 ! 
z0 1000555 !001053 !0000022b 1005.50e+00 10000005.50 | 
1 555 1 1053 1 22b | 5.50e+00 1 5.50 1 
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putc 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


スト リー ム に 1 文字 を 出力 し ます 。 


#include<stdio.h> 
int putc(int c, FILE * seg) ・ 


stdio.h 


pute は , 文字 c を s/eg に 指定 され た スト リー ム へ 出力 する マク ロ で す 。 


成功 し た 場合 , pute は 出力 し た 文字 c を 返し ます 。 エ ラー の 場合 は EOF を 
返し ます 。 


putc は UNIX シス テム て 使用 で き 、 ANSIC と 互換 性 が あり ます 。K&R 
で も 定義 き 8 れ て いま す 。 


fprintf, fputc, fputch, getc, getchar, printf, putch, putchar 
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putch 

機能 画面 に 1 文字 を 出力 し ます 。 

形式 int putch(int c) : 

プロ ト タ イ プ conio.h 

解説 putch は , 文字 < を カレ ント テキ スト ウイ ンド ウ に 出力 し ます 。 putch は , 
コン ソー ル へ の 直接 出力 を 行なう テキ スト モー ド 関 数 で す 。putch は 。 改行 
文字 (\ ぎ n) を CR/LF ベア に 変換 し ませ ん 。 

戻り 値 成功 し た 場合 , putch は 印字 し た 文字 c を 返し ます 。 エ ラー の 場合 に は 
EOF を 返し ます 。 

可 搬性 putch は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 し 
ます 。 

関連 項目 cprintf, cputs, getch, getche, putc, putchar 

318 
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putchar 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 


sdogf へ 文字 を 出力 し ます 。 


#include <stdio.h> 


int putchar(int c) : 


stdio.h 


putchar(c) は , pute(c, sdoz7) と 定義 され た マク ロ で す 。 


成功 し た 場合 , putchar は 文字 c を 返し ます 。 エラ ー の 場合 に は EOF を 返 
し ます 。 


putchar は UNIX シス テム て 使用 で き , ANSIC と 互換 性 が あり ます 。K& 
R で も 定義 きれ て いま す 。 


fputchar, getc, getchar, putc, putch, puts 
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putenv 


形式 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬 性 


320 


現在 の 環境 変数 に 文字 列 を 追加 し ます 。 
int putenv(const char * zg7e) : 


stdlib.h 


putenv は , 文字 列 zgzze を 引数 に と り , それ を 現在 の プロ セス の 環境 に 追 
加 し ます 。 た と えば 次 の よ うに 呼び 出し ます 。 


Putenv( "PATHmA:\FOO0" ) : 


putenvy は 、 す で に ある zgze を 変更 また は 削除 する た め に も 使用 で きま 
す 。 削 除 する と き は , その 変数 の 値 を 空 に し ます (た と えば "MYVAR=" 
の よう に 指定 し ます )。 

putenv が 変更 する の は 現在 の プロ グラ ム の 環境 だ け で す 。 プ ログ ラム が 終 
了 す れ ば 元 の 環境 が 回 復 さ れ ま す 。 

putenv は , 成功 し た 場合 は 0 を 返し ,. エラ ー の 場合 は -1 を 返し ます 。 
putenv は UNIX シス テム で 使用 で きま す 。 


getenv 
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機能 sdoz7 に 文字 列 を 出力 し ます 。 
形式 int puts(const char * 5) : 
プロ ト タ イ プ stdio.h 


解説 puts は , ヌル 文字 で 終わ る 文字 列 s を 、 標準 出力 スト リー ム sog7 に 出力 
し , 最後 に 改行 文字 を つけ ます 。 


戻り 値 puts は , 成功 し た 場合 は 負 で な い 値 を 返し . エラ ー の 場合 は EOF を 返し ま 
す 。 

可 搬性 puts は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あ り ます 。 

関連 項目 cputs, fputs, gets, printf, putchar 
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プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 


322 


スト リー ム に 整数 を 出力 し ます 。 


#include <stdio.h> 
int putw(int w, FILE * segz) 


stdio.h 


putw は , 整数 w を 出力 スト リー ム seg7z に 出力 し ます 。putw は , ファ 
イル の 中 で の 特別 な アラ イン メン ト は 想定 し て お ら ず , また 行ない ませ ん 。 


putw は , 成功 し た 場合 は 整数 w を 返し ます 。 エラ ー の 場合 は は EOF を 返 
し ます 。 

EOF は putw が 正常 な 値 と し て 返す 整数 な の で , putw の エラ ー を 検出 す 
る に は ferror を 使用 する べき で す 。 


putw は UNIX シス テム て 使用 で きま す 。 


getw, printf 
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qSort 


機能 クイ ッ ク ソ ー ト アル ゴリ ズム を 用 いて ソー ト を 行ない ます 。 


形式 Void qsort(void * の 9se, size t 7e/e7i。 Size t wi が, 


int (* 2p) (const void *※、 const void ※)) : 


プロ ト タ イ プ stdlib.h 


解説 qsort は 、 クイ ッ ク ソ ー ト アル ゴリ ズム の 1 つ "3 つ の メデ ィ ア ン " を 実現 し 
た も の で す 。 qsort は /czp が 指す ユー ザ 定義 の 比較 関数 を 繰り 返し 呼び 
出し て , テー ブル 中 の 項目 を ソー ト し ます 。 


較 62ie は 。 ソー ト さ れる べき テー ブル の ベー ス (つま り 0 番 目 の 要 来 ) を 
指し て いま す 。 

圏 ec: は テー ブル 中 の 項目 の 数 で す 。 

田 7 は テー ブル 中 の 各 項 目 の 大 き さ (単位 : バイ ト ) で す 。 


比較 関数 * /cp は , 2 つの 引数 efe/ と efe2 を と り ま す 。2 つ の 引数 は テ 
ー プ ブル 中 の 項目 へ の ポイ ンタ で す 。 比 較 関 数 は この 2 つの 項目 (* eeyz7,*※ 
eezz2) を 比較 し , その 比較 結果 を 整数 で 返し ます 。 


比較 結果 cz の の 戻り 値 
* eez77 < ※ e/ezz2 負 の 整数 

* efezz/ ニー ※* eez,2 0 

* eez7 > ※ eez2 正 の 整数 


不 等 号 < は 。 左側 の 項目 が , 最終 的 に ソー ト され た 並び に お いて , 右側 の 項 
目 よ り 前 に 来る べき で ある こと を 意味 し ます 。 同 様 に , > は 左側 の 項目 が , 

最終 的 に ソー ト さ れ た 並び に お いて , 右側 の 項目 より 後に 来る べき で ある 
こと を 意味 し ます 。 
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324 


あり ませ ん 。 


qsort は UNIX シス テム て 使用 てき, ANSI C と 互換 性 が あり ます 。 


bsearch、lsearch 


#1nclude <stdio.h> 
#1nc1ude <std1ib.h> 
すず include <string.h> 


char 1ist[5][4] = ( "cat*。 "car*。 "cab"。 "cap"。 "can' )j 


main() 


{ 
nt Yi 


qsort(&1ist。 5。 slzeof(11st[10] ) , strcmp)i 
for (x = 0j x < 5j x++) 
printf(*Xswn'。 11st[x]): 


プロ グラ ム 出 力 


cab 
can 
cap 
Car 
cat 
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機能 


形式 


プロ ト タ イ プ 


戻り 値 


実行 中 の プロ グラ ム に ソフ トウ ェ ア シ グ ナ ル を 送り ます 。 


#include <signal.h> 
int raise(int s 放 ) : 


signalh 


raise は sg 型 の シグ ナル を プロ グラ ム に 送り ます 。 sjg に よっ て 指定 され 
る シグ ナル 型 に 対す る シグ ナル ハン ドラ が イン スト ー ル され て いる 場合 は 。 
その ハン ドラ が か 実行 され ます 。 ハ ンド ラ が イン スト ー ル され て いな い 場 合 
は , その シグ ナル 型 に 対す る デフ ォ ル ト の 処理 が 行なわ れ ま す 。 

シグ ナル 型 は signal.h の 中 で 次 の よう に 定義 され て いま す 。 


ーーーーーーーーーーーーーーーーーーーーーーー 
シグ ナル 意味 


SIGABRT 異常 終了 (*) 

SIGFPE 正しく な い 浮 動 小数 点 演算 

SIGILL 不当 な 命令 (⑧ 

SIGINT コン トロ ー ル プレ ー ク 割り 込み 

SIGSEGV 主 記憶 に 対す る 正しく な い ア クセ ス (3 

SIGTERM プロ グラ ム 終 了 の 要求 (*) 
ーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


アス タリ スク *※* が つい て いる シグ ナル 型 は , 通常 の 操作 で は DOS や 
Turbo C に よっ て 生成 され る こと は あり ませ ん 。 そ れ ら は raise で 生成 さ 
れる も の で す 。 シャー プ #* つ いて いる シグ ナル は , 8088 や 8086 プ ロ セ ッ サ 
で は 非同期 的 に 生成 する こと は で きま せん が , 他 の プロ セッ サ で は 生成 き 
れる こと が あり ます (詳し く は signal の 解説 を 参照 し て くだ さい )。 


成功 し た 場合 は 0、 そう で な いり 場合 は 0 以外 の 値 を 返し ます 。 
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可 搬性 raise は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


関連 項目 abort, signal 


例 旭 nc1ude <e1gna1.h> 


main() 
{ 
nt a。b。 ci 


a = 10i 
b < 0: 
1f (b == 0) 


raiee(STGPPE): /* ゼロ 除算 エラ ー を 取り 除く */ 
c=a/bs 
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rand 


機能 乱数 発生 ルー チン で す 。 

形式 int rand(void) : 

プロ ト タ イ プ stdlib.h 

解説 rand は 。 周期 2 の 乗法 合同 法 を 用 いて 乱数 を 発生 し 、 呼び 出さ れる た び 


に 0 一 RAND_MAX の 間 の 医 似 乱数 を 返し ます 。 シ ン ポ リッ ク 定 数 RAND 
MAX は stdlib.h の 中 で 定義 され て お り , 値 は 2 15 土 1 で す 。 


戻り 値 rand は , 生成 し た 髪 似 乱数 値 を 返し ます 。 

可 搬性 rand は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 
関連 項目 random, randomize, srand 

例 ま #1nc1ude <time.h> 


ま 1nclude <stdio.h> 
#1nc1ude <std1ib.h> 


main() /* 0 て 32767 の 範囲 の 5 つの 乱数 を 表示 する き / 
6 
nt ii 
srand(time(NULL) ? 37): /* ラン ダム な 値 か ら 始め る */ 


for (1=0: 1<5:』 オキ ) 
Printf("Zd\n* 。 rand() ) 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


randbrd 
機能 ラン ダム な プ ブロック 読み 出し を 行ない ます 。 
形式 #include <dos.h> 


int randbrd(struct fcb * た の , int 7cz/) : 


プロ ト タ イ プ dosh 


解説 randbrd は , たち が 指す オー プン され て いる ファ イル コン トロ ー ル プロ ッ 
ク (FCB) を 使っ て , zz7 個 の レコ ー ド を 読み 込み ます 。 レ コー ド は , 現 
在 の ディ スク 転送 アド レス (DTA) の メモ リ に , FCB の ラン ダム レコ ー ド 
フィ ー ル ド て で 指定 され た ディ スク レコ ュー ド か ら 読 まれ ます 。 こ れ は DOS 
シス テム コー ル 0x27 を 呼び 出す こと に よっ て 行なわ れ ま す 。 
実際 に 読み 出さ れ た レコ ー ド の 数 は , FCB の ラン ダム レコ ー ド フィ ー ル ド 
を 調べ る こと に よっ て 得る こと が で きま す 。 ラ ンダ ムレ コー ド フ ィ ー ル ド 
は , 実際 に 読み 出さ れ た レコ ー ド 数 だ け 増 加 し ます 。 


戻り 値 randbrd の 結果 に よっ て 次 に 示す 値 が 返さ れ ま す 。 


0 すべ て の レコ ー ド が 読み 込ま れ ま し た 。 

1 、EOF に 達し , 最後 の レコ ー ド は 完全 に 読み 込ま れ ま し た 。 

2 読み 込む レコ ー ド が OxFFFF を 越え ます (可能 な 最大 数 の レコ ー 
ド が 読ま れ ま し た )。 

3 。EOF に 達し , 最後 の レコ ー ド は 不 完全 で し た 。 


可 搬性 randbrd は MS-DOS に 特有 な 関数 で す 。 
関連 項目 getdta, randbwr, setdta 
328 
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nn ms 
randbwr 


機能 ラン ダム な ブロ ッ ク 書 き 込み を 行 を いま す 。 


形式 #include<dos.h> 
int randbwr (struct fcb * た . int 7cz/) : 


プロ ト タ イ プ dosh 


解説 randbwr は , /c ち が 指す オー プン され て いる ファ イル コン トロ ー ル ブロッ 
ク (FCB) を 使っ て , 7czz 個 の レコ ー ド を 書き 込み ます 。 レ コー ド は , 現 
在 の ディ スク 転送 アド レス (DTA) の メモ リ か ら , FCB の ラン ダム レコ ュー 
ド フ ィ ー ル ド で 指定 され た ディ スク レコ ー ド へ 書き 込ま れ ま す 。 こ れ は ,。 
DOS シス テム コー ル 0x28 を 呼び 出す こと に よっ て 行なわ れ ま す 。/7cz が 0 
の 場合 、 フ ァイル の 長 さ は 、 ラン ダム レコ ー ド フィ ー ル ド が 示し て いる 値 
に セッ ト さ れ ま す 。 
実際 に 書き 込ま れ た レコ ー ド の 数 は , FCB の ラン ダム レコ ュー ド フ ィ ー ル ド 
を 調べ る こと に よっ て 得る こと が で きま す 。 ラ ンダ ムレ コー ド フ フィ ー ル 
ド は , 実際 に 読み 出さ れ た 、 あるいは 書き 込ま れ た レコ ュー ド 数 だ け 増 加 し 
ます 。 


戻り 値 randbwr の 結果 に よっ て 次 に 示す 値 が 返さ れ ま す 。 
0 すべ て の レ ュ コード が 書き 込ま れ ま し た 。 
1 レコ ー ド を 書き 込む だ け の ディ スク 領域 が あり ませ ん (レコ ー ド は 
いっ さい 書き 込ま れ ま せん ) 。 
2 書き込も うと する レコ ー ド が OxFFFF を 越え ます (可能 な 最大 数 
の レコ ー ド が 書き 込ま れ ま し た )。 


可 搬性 randbwr は MS-DOS に 特有 な 関数 で す 。 


関連 項 randbrd 
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random 


機能 


形式 


プロ ト タ イ プ 


解説 


330 


乱数 発生 ルー チン で す 。 


#include <stdlib.h> 


int random(int zz) : 


stdlib.h 


random は , 0 と (zz-1) の 間 の 乱数 を 返し ます 。random (ze7) は 、 マ ク 
ロ と し て (rand() % (zz) ) と 定義 され て いま す 。 zw7』 と 返さ れる 乱数 は 
どちら も 整数 で す 。 


random は 、 0 と (zz-1) の 間 の 数 値 を 返し ます 。 


これ に 対応 する 関数 が Turbo Pascal に も あり ます 。 


rand, randomize, srand 


す #1nclude <std1ib.h> 
ず #1nclude <time .h> 


/* 0 て 99 の 範囲 の 乱数 を , ラン ダム な 個数 出力 する */ 
main() 


{ 


nt ni 


randomize(): 
/* 1>20 の 範囲 の ラン ダム な 値 を と る */ 
n = random(20) + 1 
while (n-- > 0) 

Printf ("2d *。 random (100) ): 
PrintE("Wn")i 
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ニー ニー ニー ュー ーー ニュ ーー ニー ニー ニー テー ニニ ー= ニーニョ 
randomize 


機能 乱数 発生 ルー チン を 初期 化し ます 。 


形式 #include <stdlib.h> 
#include <time.h> 
void randomize(void) : 


プロ ト タ イ プ stdiibh 


解説 randomize は 、 ラン ダム な 値 に よっ て 乱数 発生 レー チン を 初期 化し ます 。 
randomize は 、 ヘッ ダフ ァイル timeh で プロ ト タイ ププ 宣言 さ れ て いる 
time 関数 を 呼び 出す オマ クロ な の で , この 関数 を 使う 場合 は , time.h を イン 
クル ー ド する よう に し て くだ さい 。 


戻り 値 戻り 値 は あり ませ ん 。 
可 搬性 これ に 対応 する 関数 が Turbo Pascal に も あり ます 。 
関連 項目 rand, random, srand 
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_read 


機能 ファ イル か ら 読 み 込み を 行ない ます 。 
形式 int read(int Agzgfe, void * が /, unsigned /) : 
プロ ト タ イ プ ioh 


解説 _read は , ヵ g2 の 7e に 結び つけ られ て いる ファ イル か ら /gg バイ ト を 読み 込 
ん で , が が 指し て いる バッ ファ に 格納 し ます 。 read は 、 DOS シス テム 
コー ル を 直接 呼び 出し ます 。 
テキ スト モー ド で オー プン され た ファ イル に 対し て は , read は 復帰 文字 

(0x0D) を 削除 し ませ ん 。 

gz の 7e は 、 creat、 open、 dup、dup2 の 呼び 出し で 得 ら れ た ファ イル ハン 
ドル で す 。 

ディ スク ファ イル で は , _read は 現在 の ファ イル ポイ ンタ の 位置 か ら 読み 
込み を 開始 し ます 。 読 み 込み が 終了 し た と き に , ファ イル ポイ ンタ を 読み 
込ん だ バイ ト 数 だ け イ ンク リ メ ン ト し ます 。 デ バイ ス の 場合 は 、。 バイ ト は 
デバ イス か ら 直 接 読ま れ ま す 。 
_read で 読み 込め る バイ ト 数 は 最大 65534 バ イト で す 。65535 (0xFFFF) は 
-1 と 同じ で あり , エラ ー を 示す た め に 使用 され ます 。 


戻り 値 成功 し た 場合 。 read は バッ ファ に 格納 され た バイ ト 数 を 示す 正 の 整数 を 
返し ます 。 ファ イル エン ド を 読み 込ん だ 場合 は 0 を 返し ます 。 エラ ー の 場合 
は -1 を 返し , errzzo に 大 の いずれ か の 値 を セッ ト し ます 。 


EACCES アク セス が 拒否 され た 
EBADF ファ イル 番号 が 正しく な い 


可 搬性 _read は MS-DOS に 特有 の 関数 で す 。 


関連 項目 _open, read, write 
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read 

機能 ファ イル か ら 読 み 込み を 行ない ます 。 

形式 int read(int Agzge, void * 7, unsigned / ヵ ) : 

プロ ト タ イ プ ioh 

解説 read は , gzde と 結び つけ られ て いる ファ イル か ら gg バイ ト を 読み 込ん 
で , が が 指し て いる バッ ファ に 格納 し ます 。 
テキ スト モー ド で オー プン され た ファ イル に 対し て は , read は 復帰 文字 を 
削除 し 。 ファ イル エン ド を 読み 込ん だ と き に は , それ を 知ら せま す 。 
42z9/e は , creat。 open。dup, dup2 の 呼び 出し で 得 ら れ た ファ イル ハン 
ドル で す 。 
ディ スク ファ イル で は , read は , 現在 の ファ イル ポイ ンタ の 位置 か ら 読み 
込み を 開始 し ます 。 読 み 込み が 終了 し た と き に , ファ イル ポイ ンタ を 読み 
込ん を だ バイ ト 数 だ け イ ンク リ メ ン ト し ます 。 デ バイ ス の 場合 は ,。 バイ ト は 
デバ イス か ら 直 接 読ま れ ます 。 
read で 読み 込め る バイ ト 数 は 最大 65534 バ イト で す 。65535 (OxFFFF) は 
-1 と 同じ で あり , エラ ー を 示す た め に 使用 され ます 。 

戻り 値 成功 し た 場合 , read は 、 バ ッ フ ァ に 格納 され た バイ ト 数 を 示す 正 の 整数 を 
返し ます 。 フ ァイル が テキ スト モー ド で オー プン され て いる 場合 は , read 
は 復帰 文字 お よび CTRL-Z 文字 は カウ ント し ませ ん 。 
ファ イル エン ド を 読み 込ん だ 場合 は 0 を 返し ます 。 エ ラー の 場合 は -1 を 返 
し , er7zzo に 次 の い ずれ か の 値 を セッ ト し ます 。 

EACCES アク セス が 拒否 され た 
EBADF ファ イル 番号 が 正しく な い 
可 搬性 read は UNIX シス テム て 使用 で きま す 。 
関連 項目 open, read, write 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


realloc 

機能 メモ リ の 再 割 り 当 て を 行ない ます 。 

形式 #include <stdlib.h> 
void * realloc(void * が oc ん, size t sze) : 

プロ ト タ イ プ stdliib.h、alloch 

解説 realloc は 、 す で に 確保 され て いる プロ ッ ク を , sze バイ ト に 縮小 また は 拡 
張 し ます 。 引 数 oc を は , 以前 の malloc, calloc, ある い は realloc の 呼び 
出し で 得 ら れ た メモ リプ ロッ ク を 指す ポイ ンタ で す 。 oc を が ヌメ ルポ イン 
タ の 場合 に は realloc は malloc と まっ た く 同 じ よ うに 機能 し ます 。 
realloc は , 割り 当て 済み の プロ ッ ク を の サイ ズ を se に 調整 し , 必要 で あ 
れ ば プロ ッ ク の 内 容 を 新しい 領域 に コピ ー し ます 。 

戻り 値 realloc は , 再 割 り 当 て され た プロ ッ ク の アド レス を 返し ます 。 こ れ は , 以 
前 の プロ ッ ク の アド レス と は 異な る 場合 も あり ます 。 プ ロッ ク を 再 割 り 当 
て で き な か っ た 場合 , ある い は sze ニ =0 の 場合 に は NULL を 返し ます 。 

可 搬性 realloc は UNIX シス テム て で 使用 で き , ANSI C と 互換 性 が あ り ます 。 

関連 項目 calloc, farrealloc、free, malloc 

例 malloc を 参照 し て くだ さい 。 
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TeImOVe 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


ファ イル を 削除 し ます 。 


#include <stdio.h> 
int remove(const char * 7egzg7ze) : 


stdio.h 


remove は ,//ezgze に 指定 され た ファ イル を 削除 し ます 。 remove は , 単 
に umlink の 呼び 出し に 展開 され る マク ロ で す 。 


成功 し た 場合 は 0 を 返し ます 。 エラ ー の 場合 は -1 を 返し , eryzo に 次 の い ず 
れ か を セッ ト し ます 。 


ENOENT その よう な ファ イル ある い は ディ レク トリ は な い 
EACCES アク セス が 拒否 され た 


remove は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


unlink 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


Telarme 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


336 


ファ イル 名 を 変更 し ます 。 


int rename(const char * o/zg7e, ConSt char * 7ew777e) : 


stdio.h 


rename は 、 フ ァイル の 名 前 を gzgze か ら zewzg/ie に 変更 し ます 。 zew- 
2g7 が ie に ドラ イブ 名 の 指定 が ある 場合 は 、 ogzgze の も の と 同じ し で な けれ 
ば な り ま せん 。 

バス 名 の 中 の ディ レク トリ は 同じ で ある 必要 は あり ませ ん 。 し た が っ て , 
rename に よっ て , ファ イル を ある ディ レク トリ か ら 別 の ディ レク トリ に 
移す こと も で きま す 。 ワ イル ドカ ー ド は 使え ませ ん 。 


成功 し た 場合 rename は 0 を 返し ます 。 エ ラー の 場合 は -1 を 返し , eryzo 
に 次 の 値 の いずれ か を セッ ト し ます 。 


ENOENT その よう な ファ イル また は ディ レク トリ は な い 
EACCES アク セス が 拒否 され た 


ENOTSAM 同じ デバ イス で は な い 


rename は ANSI C と 互換 性 が あり ます 。 
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ニーーー ニ ーーー ュー ニョ ニー ニー ニー ニー デー ーー ーー ーーー 
rewind 


機能 ファ イル ポイ ンタ を ファ イル の 先頭 に 移動 し ます 。 


形式 #include <stdio.h> 
void rewind (FILE * seg) : 


プロ ト タ イ プ stdioh 


解説 rewind(seg) は 、fseek(seg, 0L,SEEK SET) と ほぼ 同じ に です 。 た だ 
し , rewind は ファ イル 終了 標識 と エラ ー 標 識 の 両方 を クリ ア し ます が , 
fseek は ファ イル 終了 標識 の み を クリ ア し ます 。 
更新 用 に オー プン され た ファ イル で は , rewind を 呼び 出し た 後 は , 入 力 ・ 
出力 どちら で も 行なう こと が で きま す 。 


戻り 値 あり ませ ん 。 
可 搬性 rewind は すべ て の UNIX シス テム て で 使用 で き , ANSI C と 互換 性 が あり 
ます 。 


関連 項目 fopen、fseek, ftell 


例 fseek を 参照 し て くだ さい 。 
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rmdir 


形式 


プロ ト タ イ プ 


戻り 値 


338 


ディ レク トリ を 削除 し ます 。 


int rmdir (const char * /g 旋 ) : 


dirh 


rmdir は , /g 廊 に 指定 され た ディ レク トリ を 削除 し ます 。 pg が が 示す ディ 
レク トリ 名 は , 


較 空 で な けれ ば な り ま せん 。 
罰 現 在 の 作業 ディ レク トリ で あっ て は な り ま せん 。 


田 ル ー ト ディ レク トリ で あっ て は な り ま せん 。 


rmdir は ,、 ディ レク トリ を 削除 で きた 場合 に は 0 を 返し ます 。 エラ ー の 場合 
は -1 を 返し , eryzzo に 次 の いずれ か を セッ ト し ます 。 


EACCESS "アク セス が 否定 され て いる 
ENOENT バス 名 また は ファ イル 名 が 見 つか ら な い 


chdir, getcurdir, getcwd, mkdir 
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_rotl 


形式 


プロ ト タ イ プ 


解脱 


符号 な し 整数 値 を ビッ ト ご と に 左 ヘ ローテート し ます 。 


unsigned rotl(unsigned yg/ze, int cogz7) : 


stdlib.h 


_rotl は , 与え られ た 値 yg/we を cozz7 ビッ ト だ け 左 へ ロー テー ト し ます 。 


ロー テー ト さ れる 値 は unsigned で す 。 


_rotl は , 左 へ coz7 ビッ トロ ー テ ー ト し た 値 を 返し ます 。 


_lrotl 


ず す 1nclude <std1ib.h> 


main() 
t 
Printf("rotate OxABCD 4 bits 1eft = Z04XWn"。 
_rot1(0xABCD。 4) ) 
Printf(*rotate OxABCD 4 blts right = Z04XWnr, 
_rotr(OxABCD。 4) ): 
printf(*rotate Ox55555555 1 blt 1eft = Z081XWn*。 
_1rot1(0x55555555L, 1 ) ) : 
Printf(*rotate OxAAAAAAAA 1 bit right = Z081XWn*。 
-1rotr(0xAAAAAAAAL。 1 ) ) 


プロ グラ ム 出 力 


rotate OxABCD 4 bits 1eft = BCDA 
rotate OxABCD 4 bits right = DABC 
rotate Ox55555555 1 bit 1eft = AAAAAAAA 
rotate OxAAAAAAAA 1 bit right = 55555555 
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_rotr 


機能 符号 な し 整数 値 を ビッ ト ご と に 右 へ ロー テー ト し ます 。 
形式 unsigned rotr(unsigned vg/we, int coz/) : 


プロ ト タ イ プ stdlib.h 


解説 _rotr は , 与え られ た 値 yg/e を cog7 ビッ ト だ け 右 へ ロー テー ト し ます 。 
ロー テー ト さ れる 値 は unsigned で す 。 


戻り 値 _rotr は 右 へ coz7 ビッ トロ ー テ ー ト し た 値 を 返し ます 。 
関連 項目 _lrotr 

例 _rotl を 参照 し て くだ さい 。 

340 
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機能 デー タ セ グ メ ント 領域 の 割り 当て を 変更 し ます 。 

形式 void * sbrk(int ey) : 

プロ ト タ イ プ alloch 

解説 sbrk は , プレ ー ク 値 (デー タ セ グ メ ント の すぐ 後ろ の アド レス ) に er を 
加え , これ に 従っ て 割り 当て スペ ー ス を 変更 し ます 。/wer は 負 の 値 で も か 
まわ ず , その 場合 に は 割り 当て スペ ー ス が 小さ く な り ま す 。 
Sbrk は 、 シ ステ ム で 許さ れる 大 き さ を 越え る スペ ー ス を 確保 し よう と し た 


場合 に は エラ ー と な り , 割り 当て スペ ー ス の 変更 は 行ない ませ ん 。 


戻り 値 割り 当て スペ ー ス の 変更 に 成功 し た 場合 , sbrk は 変更 前 の プレ ー ク 値 を 返 
し ます 。 和 失敗 し た 場合 に は -1 を 返し 、 eryzo を 次 の 値 に セッ ト し ます 。 


ENOMEM メモ リ が 不足 し た 


可 搬 性 sbrk は UNIX て 使用 で きま す 。 


関連 項目 brk 
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SCanf 


機能 


形式 


プロ ト タ イ プ 
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スト リー ム sz の iz を スキ ャ ン し て 書式 つき 入力 を 行ない ます 。 
int scanf(const char * /oryzgf [, gg の 7ess,…]) : 
stdio.h 


scanf は 一連 の 入力 フィ ー ル ド を スキ ャ ン し て , 一 度 に 1 文字 ずつ スト リ 
ー ム 5 か ら 文字 を 読み 込み ます 。 次 に , 引数 prig7 に よっ て 指 さ れ る 
書式 文字 列 中 の 書式 指定 に し た が っ て , 各 フ ィ ー ル ド を 書式 化し ます 。 最 
後に , ozg7 の 後に 続く 各 引 数 が 示し て いる アド レス に , 書式 化し た 入力 
を 格納 し て いき ます 。 書式 文字 列 中 の 書式 指定 の 個数 は 、 その 後に 続く ア 
ドレ ス の 数 と 同じ で な けれ ば な り ま せん 。 


書式 文字 列 : 

scamf お よび 関連 する 関数 (cscanf, fscanf, sscanf, vscanf, vfscanf, 
Ysscanf) の 書式 文字 列 は , 各 関 数 が 入力 フィ ー ル ド を , どの よう に スキ 
ャ ン レ し, 変換 し , また 格納 する か を 制御 し ます 。 書 式 指定 と 同じ 個数 の 
アド レス 引数 が 存在 し な けれ ば な り ま せん 。 ア ドレ ス 引 数 が た りな い 場 
合 は 結果 は 予測 で き な い , ひど いも の に な る は ず で す 。 多 す ぎる 場合 は 
単に 無視 され る だ け で す 。 

書式 文字 列 に は , 次 の 3 種類 の オプ ジェ クト が 含ま れ て いま す 。 ホワ イト 
スペ ー ス , 非 ホ ワイ トス ペー ス , 書式 指定 で す 。 


田 ホ ワイ トス ペー ス は 。 空白 、 タ プ ()、 復 改 ( ま n) で す 。 
…・Scanf 関数 が 書式 文字 列 中 の ホワ イト スペ ー ス に 出会う と , 入力 に 
お ける ホワ イト スペ ー ス を , 次 に 非 ホ ワイ トス ペー ス が 現われ る まで 
読み と ば し ます 。 

一 非 ホワ イト スペ ー ス は , 災 文 字 以 外 の すべ て の ASCII 文字 で す 。 
…・Scanf 関数 が 書式 文字 列 の 中 で 非 ホ ま ワ イト スペース に 出会う と , そ 
れ に 一 致す る 文字 を 読み ます 。 

玉 書 式 指定 は , ... scanf 関数 に , 入力 フィ ー ル ド を 読ん で 変換 し , アド レ 
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ス 引 数 で 指定 され る 場所 へ 格納 する こと を 指示 し ます 。 


後に 続く ホワ イト スペ ー ス は , 書式 文字 列 の 中 で マッ チ す る も の が な い 
限り , ( 復 改 も 含め て ) 読ま れ ま せん 。 


書式 指定 : 
….Scanf の 書式 指定 は 克 の よう な 形式 を と り ま す 。 


は] [入力 幅 ] [FIN] [hiL] 型 指定 文字 


書式 指定 は 必 ら ず % で 始ま り ます 。% の 後に は , 次 に 示す も の が , この 
順 で 現われ ます 。 


圏 オプ ショ ン の 代入 抑制 文字 (*) 

圏 オ プシ ョ ン の 入力 幅 指定 子 

較 オ プシ ョ ン の ポイ ンタ サイ ズ 指 定子 (F また は N) 
田 オ プシ ョ ン の 引数 型 修飾 子 (h。 1 また は し L) 

還 型 指定 文字 
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書式 文字 列 中 の オプ ショ ン の 要素 : 
…・Scanf の 書式 文字 列 の 中 の 指定 する オプ ショ ン の 要素 の 働き を 次 に 


示し ます 。 
文字 / 指 定子 働き 
※ 次 の 入力 フィ ー ル ド を 読み と ば す 。 

入力 幅 読む べき 文字 数 の 最大 値 。. scanf 関数 が ホワ イト スペ 
ー ス ある い は 変換 不能 文字 に 出会っ た 場合 は ,、 これ より 
少な い 文 字 し か 読ま れ な いこ と も ある 。 

サイ ズ アド レス 引数 の デフ ォ ル ト の サイ ズ を 変更 する 。 
/ = near ポイ ンタ 
三 far ポイ ンタ 

引数 の 型 アド レス 引数 の アデ フォル ト の 型 を 変更 する 。 


三 short int 

7 = long int ( 型 指定 文字 が 整数 変換 を 指示 し て いる 場 
合 ) 

7 = double ( 型 指定 文字 が 浮動 小数 点 変換 を 指示 し て い 
る 場合 ) 

= long double (浮動 小数 点 変換 の 場合 に の み 有 効 ) 
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…・Scanf 型 指定 文字 : 
の 表 に は ,...scanf の 型 指定 文字 , 期待 され る 入力 の 型 , 入力 が どの よ 
う を 書式 で 格納 され る か が 示さ れ て いま す 。 
この 表 に 示し た 情報 は 。 オプ ショ ン の 文字 , 指定 子 , 修飾 子 (*, 入力 
幅 、 サイ ズ ) が 書式 指定 に 指定 きれ て いな いり 場合 の も の で す 。 オ プシ ョ 
ン を 追加 し た と き に どう な る か に つい て は , この 後 の 表 を 参照 し て くだ 
さい 。 


ーーーーーーーーーーーーーーーーーーーーーーー ノ ノ 、、 
型 指定 文字 期待 され る 入力 引数 の 型 


数 値 
d 10 進 整数 int へ の ポイ ンタ (int * gzg) 
D 10 進 整数 long へ の ポイ ンタ (ling * gg) 
o 8 進 整 数 int へ の ポイ ンタ (int * grg) 
O 8 進 整数 long へ の ポイ ンタ (long * grg) 
i 10/8/16 進 整数 int へ の ポイ ンタ (int * gg) 
I 10/8/16 進 整数 long へ の ポイ ンタ (long * gyg) 
u 符号 な し 10 進 整数 unsigned int へ の ポイ ンタ 
(unsigned int * grg) 
U 符号 な し 10 進 整数 unsigned long へ の ポイ ンタ 
(unsigned long * grg) 
に 3 16 進 整数 int へ の ポイ ンタ (int * gyg) 
え 16 進 整数 long へ の ポイ ンタ (long * gg) 
e 浮動 小数 点数 float へ の ポイ ンタ (/7og7 * gzs) 
E 肖 動 小数 点数 float へ の ポイ ンタ (float * gg) 
人 光 動 小数 点数 float へ の ポイ ンタ (float * gyg) 
g 浮動 小数 点数 float へ の ポイ ンタ (float * gg) 
G 浮動 小数 点数 float へ の ポイ ンタ (float * gzg) 
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文字 


ゞ 文字 列 文字 配列 へ の ポイ ンタ (char の sg[]) 
< 文字 文字 へ の ポイ ンタ (char * の g) 
フィ ー ル ド 幅 w が c に つい て いる 場 
合 (%5c の よう に ) は , w 個 の 文字 か 
ら な る 配列 を 指す ポイ ンタ (char grg 
[w]) 


% % 文 字 変換 は , 行なわ れず , 単に % 文 字 が 格 
納 さ れる 。 
ポイ ンタ 
カ (な し ) int 型 へ の ポイ ンタ (int * gg) 


%n ま で で , 正しく 読み 込ま れ た 文字 
数 が この int に 格納 され る 。 


リノ 16 進 数 ある オプ ジェ クト へ の ポイ ンタ 
YYYY : ZZZZ 形式 (far *※ ま た は near *) 
また は ZZZZ 形式 %p 変換 は , メモ リモ デル に お ける デ 


フォ ルト の ポイ ンタ サイ ズ に な る 。 


入力 フィ ー ル ド : 
入力 フィ ー ル ド は , 次 に 示す も の の いずれ か で す 。 


田 次 の ホワ イト スペ ー ス (これ は 含ま れ な い ) まで の すべ て の 文字 

田 現 在 の 書式 指定 で は 変換 する こと が で き な い 文字 まで の すべ て の 文字 
(た と えば , 8 進 形式 で の 8 また は 9) 

田 み が フィ ー ル ド 幅 と し て 指定 され て いる 場合 は ヵ 文字 まで 。 
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慣例 : 
書式 指定 の いく つか に つい て は , 次 に 示す よう を な 慣 例 が あり ます 。 


% < 変換 

この 指定 子 は 、 ホワ イト スペ ー ス を 含め て 次 の 文字 を 読み 込み ます 。 ホ 
ワイ トス ペー ス を スキ ッ プ し , 次 の 非 ホ ワイ トス ペー ス を 読み 込む た め 
に は , %1s を 使用 し て くだ さい 。 


% Wec 変換 (W 入力 幅 指定 子 ) 
アド レス 引数 は 文字 配列 を 指す ポイ ンタ で す 。 配 列 は W 個 の 要素 を も 
っ て いま す (char gg[W])。 


% s 変換 

アド レス 引数 は 文字 配列 を 指す ポイ ンタ で す (char grg[])。 
配列 の 大 き さ は 少な く と も (n 二 1) バイ ト で な けれ ば な り ま せん 。 ここ 
で mn は 文字 列 s の 長 さ です 。 空 白 文 字 あ る い は 復 改 文字 は 入力 フィ ー ル 
ド を 終了 させ ます 。 ヌ ル 文 字 が 自動 的 に 文字 列 の 最後 に 付加 され , 配列 の 
最後 の 要素 に 格納 され ます 。 


%[ 探 索 集合 ] 変換 

大 カッ コ [] で 囲ま れ た 文字 は , 型 指定 文字 s に 置き 換え られ ます 。 ア ドレ 
ス 引 数 は , 文字 配列 を 指す ポイ ンタ で す (char grg[])。 

カッ コ の 中 に は , 入力 文字 列 を 構成 する 文字 か ら な る 探索 集合 を 定義 す 
る 文字 を 置き ます 。 

カッ コ の 中 の 最初 に キャ レッ ト ( ) を 置く と , 探索 集合 は , 指定 され て 
いる 文字 以外 の ASCII 文字 (反転 探索 集合 ) に な り ま す (通常 , 最初 の 
キャ レッ ト の 後に キャ レッ ト が 指定 され て いな けれ ば , 探索 集合 に は キ 
ャ レッ ト も 含ま れ ま す )。 

入力 フィ ー ル ド は , ホワ イト スペ ー ス で 区 切ら れ て いな い 文 字 列 で 
す 。...scanf 関数 は 対応 する 入力 フィ ー ル ド を , 探索 集合 (ある い は 反転 
探索 集合 ) に 含ま れ な い 文 字 に 達する ま て 読み ます 。 この 変換 の 例 を 2 つ 
示し ます 。 


[abcd] 入力 フィ ー ル ド の 中 で 文字 a,b,c,d を 探索 する 
Z[^abcd] 入力 フィ ー ル ド の 中 で a,b,c,d 以外 の 文字 を 探索 する 
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また , ある 男 囲 の 文字 を 探索 集合 と し て 簡単 に 使え る 範囲 機能 を 使う こ 
と が で きま す 。 た と えば すべ て の 10 進 数 を 探索 する 次 の 変換 指定 は 。 


[0123456789] 
より 簡単 に 次 の よ うに 書く こと が で きま す 。 
[0-9] 


英 数 文字 に 関し て は , 以下 の よう な 指定 が 可能 で す 。 


え [A-Z] すべ て の 葵 大 文字 
[0-9A-2a-z] すべ て の 数 字 と 英 大 文字 と 英 小文字 
%【A-FT-2] 英 大 文字 の ACF と T ン 2 


これ ら の 変換 ルー ル は 簡単 で す 。 


較 グ ッシュ の 前 の 文字 は , 後 の 文字 よ り も ASCII コー ド が 大 きい 文字 
で な けれ ば いけ ませ ん 。 

田 グ ッシュ は , 文字 列 の 先頭 また は 最後 に あっ て は いけ ませ ん 。 も し 
先頭 か 最後 が ケッ シュ な ら ば 範囲 指定 で は な く ダ ッシュ 文字 その も 
の を 探索 し ます 。 

較 グ ダッ シュ の 前 後に 指定 する 文字 は , 他 の 範囲 の 一 部 で あっ て は いけ 
ませ ん 。 


以下 は 範囲 指定 に は な ら な い 例 で す 。 


2[- キ */] 四則 演算 子 

(z-a] <, -, a の 探索 

[+0-9-A-F] +。-。 0 て 9 と AーP 

[+0-94-F-] +。-。 0 て 9 と AF 

メ [^-0-9+A-F] +。 -,。 0 こ 9。A へ て F 以外 の ASCTI 文 字 


%e.%E,%f. %g,%G (浮動 小数 点 ) 変換 
入力 フィ ー ル ド に お ける 浮動 小数 点数 は 次 に 示す よう な 形式 を と っ て い 
な けれ ば な り ま せん 。 


は /- ]dddddddd[ .]dddd[Eie][+/-]ddd 


ここ で 日 で 囲ま れ た 部 分 は オプ ショ ン で あり , gg は 10 進 , 8 進 、 16 進 い 
ずれ か の 表記 の 数 で す 。 
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%d %i%o,%x, %D.%1. %0.%X, %c, %n 変 換 

unsigned char、 unsigned int、 unsigned long を 指す ポイ ンタ は , char. 
int, long を 指す ポイ ンタ が 許さ れる 変換 な ら ば , どこ で も 使用 で きま 
ポ 。 


代入 抑制 文字 : 
代入 抑制 文字 は アス タリ スク (*) で す 。 C の 間接 参照 ( パ ポイ ンタ ) 演算 
子 も アス タリ スク で すか ら , 間違え な いで くだ さい 。 
書式 指定 の 中 で % の 後に ま が あ る と , 次 の 入力 フィ ー ル ド は スキ ャ ン さ 
れ ま す が , 次 の ア ドレ ス 引 数 に は 割り 当て られ ませ ん 。 ス キッ プ さ れる 
入力 デー タ は , * の 後 の 型 指定 文字 が 示す 型 で ある と みな され ます 。 


入力 幅 指定 子 : 
入力 幅 指定 子 (n は 10 進 数 ) は 、 現在 の 入力 フィ ー ル ド か ら 読 まれ る べき 
文字 数 の 上 限 を 指定 する も の で す 。 
入力 フィ ー ル ド が n 文 字 よ り 小さ い 場 合 は 、. scamf 関数 は それ ら の す 
べ て の 文字 を 読み 込み 次 の フィ ー ル ド , 次 の 書式 指定 へ と 移り ます 。 
n 文字 読む 前 に 、 ホワ イト スペ ー ス や 変換 で き な い 文字 が 現れ た 場合 は , 
そこ まで の 文字 が 読み 込ま れ , 変換 され , 格納 され ます 。 その後 ま た 関 
数 は 次 の 書式 指定 に 移っ て いき ます 。 
変換 で き な い 文字 と いう の は , 与え られ た 書式 に し た が っ て 変換 する こ 
と の で き な い 文字 (た と えば , 書式 が 8 進 の と き の 8 や 9, 書式 が 16 進 の と 
き の 」 や K) の こと で す 。 


入力 幅 指定 子 入力 幅 は どの よう な 影響 を 受け る か 


mn n 文字 まで 読み 込ん で 変換 され , 現在 の アド レス 引数 に 
格納 され る 。 
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入力 サイ ズ お よび 引数 型 修飾 子 : 
入力 サイ ズ 修 飾 子 (N と ) お よび 引数 型 修飾 子 (h_ 1 お よび ) 
は ,.….scanf 関数 が 対応 する アド レス 引数 grg[f] を どう 解釈 する か に 影 
響 を 与え る も の で す 。 
F と N は , grg の デフ ォ ル ト サ イ ズ や 定 言 され た サイ ズ に 優先 し ます 。 
h, 1 お よび 上 は , 続く 入力 デー タ に どの 型 (バー ジョ ン ) が 使用 され る 
の か (h = short, 1 = long, L = long double) を 示し ます 。 入 力 デ ー 
タ は 指定 の パー ジョ ン に 変換 され , その 入力 デー タ 対 する grg は 対応 す 
る サイ ズ の オプ ジェ クト を 指す こと に な り ま す (%h の 場合 は short の 
オプ ジェ クト , %1 の 場合 は long か double の オブ プ ジェクト, %L の 場 
合 は long double の オプ ジェ クト )。 


修飾 子 変換 は どの よう な 影響 を 受け る か 


F 


N 


デフ ォ ル ト あ る い は 人 富 言 され た サイ ズ が 変更 され , grg は far 
ポイ ンタ と し て 扱わ れる 。 

デフ ォ ル ト あ る い は 人 富 言 され た サイ ズ が 変更 され , qrg は near 
ポイ ンタ し て 扱わ れる 。 ヒ ュー ジ モ デ ル で は , どの 変換 と も 一 
緒 に は 使用 で き な い 。 

dio,ux 型 : 入力 を short int に 変換 し short 型 オ プ ジ ェ クト 
に 格納 する 。 

DLO,U.X 型 : 影響 な し 。 

efie,snjp 型 : 影響 な し 。 

dio,ux 型 : 入力 を long int に 変換 し , long 型 オ プ ジ ェ クト に 
格納 する 。 

ef 型 : 入力 を double に 変換 し , double 型 オ プ ジ ェ クト に 格納 
する 。 

DiLO,U,X 型 : 影響 な し 。 

cnp 型 : 影響 な し 。 

efg 型 : 入力 を long double に 変換 し , long double 型 オ プ ジ 
ェクト に 格納 する 。 
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scanf が スキ ャ ン を や め る 場合 : 
scanf 関数 は , 通常 の フィ ー ル ド 終 了 文 字 ( ホ ワイ ト スペ ー ス ) を 読む 前 
に , さま ざま な 理由 に より , ある フィ ー ル ド の スキ ャ ン を や め る 場合 が 
あり ます 。 
scanf 関数 は , 次 に 示す こと が 起き た 場合 に は , 現在 の フィ ー ル ド の スキ 
ャ ン お よび 格納 を や め て , 次 の 入力 フィ ー ル ド へ 移り ます 。 


田代 入 抑制 文字 (*) が 書式 指定 の 中 で % の 後に 指定 され て いる 場合 。 
現在 の 入力 フィ ー ル ド は スキ ャ ン さ れ ま す が , 値 は 格納 され ませ ん 。 

田 入 力 幅 指定 子 で 指定 され て いる 個数 の 文字 を 読み 込ん だ 場合 。 

一 現 在 の 書式 で 変換 で き な い 文字 を 読ん だ 場合 (た と えば 10 進 形式 で の 
A) 

田 入 力 フィ ー ル ド の 次 の 文字 が 探索 リス ト に 入っ て いな い 場 合 。 


これ ら の 理由 か ら scamf 関数 が 現在 の 入力 フィ ー ル ド の スキ ャ ン を や 
め た と き に は , 次 の 文字 は 読み 込ま れ な か っ た も の と し , 次 の 入力 フィ 
ー ル ド の 先頭 の 文字 と な る か , ある い は 次 の 読み 込み 操作 の 先頭 の 文字 
と な り ま す 。 


scanf は 次 の 場合 に 終了 し ます 。 


田 入 力 フィ ー ル ド の 次 の 文字 が , 書式 文字 列 の 中 の 非 ホ ワイ トス ペー ス 
と 矛盾 する と き 。 

田 入 力 フィ ー ル ド の 次 の 文字 が EOF の と き 。 

田 書 式 文字 列 が すべ て 使い 果たさ れ た と き 。 


書式 文字 列 中 に , 書式 指定 の 一 部 分 で な い 文字 列 が 現われ た 場合 は , 入 
カカ フィー ルド の 現在 の 文字 の 並び と 一 致し な けれ ば な り ませ ん 。 scamf 
は , 一 致し た 文字 を スキ ャ ン し ます が 格納 は し ませ ん 。 一 致し な い 文 字 
が 現われ た と き は , その 文字 は あたかも 読ま れ な か っ た よう に , 入力 フ 
ィ ー ル ド に と ど ま っ た まま に な り ま す 。 
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戻り 値 


可 搬性 
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scanf は 、 正 し く ス キャ ン し , 変換 し , 格納 し た 入力 フィ ー ル ド の 数 を 返し 
ます 。 戻 り 値 に は , 値 を 格納 し な か っ た 入力 フィ ー ル ド の 数 は 含ま れ ま せ 
ん 。 

ファ イル エン ド を 読み 込ん だ 場合 は 戻り 値 は EOF に な り ま す 。 

値 を 格納 し た フィ ー ル ド が な か っ た 場合 は , 戻り 値 は 0 と な り ま す 。 


scanf は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。K& 
R で も 定義 きれ て いま す 。 


cscanf, fscanf, printf, sscanf, vfscanf, vsscanf 
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ーー 
searchpath 


機能 DOS の バス を 探索 し て ファ イル を 探し ます 。 


形式 char * searchpath(const char * /) : 


プロ ト タ イ プ dirh 


解説 searchpath は , 7Ze で 与え られ た ファ イル を , DOS の パス を 使っ て 探し ま 
す 。DOS の バス は , PATH=.. と いう 形式 の 文字 列 で す 。 そ の ファ イル 
の フル バス 名 の 文字 列 を 指す ポイ ンタ が 関数 値 と し て 返さ れ ま す 。 
searchpath は , 最初 に カレ ント ドラ イブ の カレ ント ディ レク トリ を チェ 
ッ ク 探 し ます 。 フ ァイル が そこ で 見 つか ら な い 場 合 は , 環境 姿 数 PATH を 
取り 出し て , その 中 の 各 デ ィ レ クト リ の 中 で 探索 を 行ない ます 。 フ ァイル 
が 見 つか る か 。 バス 名 を 使い 果たす まで 探索 を 続け ます 。 
ファ イル が 見 つか る と , その フル バス 名 を 含む 文字 列 が 返さ れ ま す 。 こ の 
文字 列 は 、 そ の ファ イル を アク セス する fopen や exec.… な どの 呼び 出し で 
使用 する こと が で きま す 。 
この 文字 列 は , 静 的 バッ ファ の 中 に 格納 され る の で , 次 の searchpath の 呼 
び 出 し に よっ て 上 書き され ます 。 


戻り 値 ファ イル が 見 つか っ た 場合 は 、 ファ イル 名 を 含む 文字 列 を 指す ポイ ンタ を 
返し ます 。 そ う でない 場 合 は NULL を 返し ます 。 


可 搬性 searchpath は MS-DOS に 特有 の 関数 で す 。 


関連 項目 exec…, SDaWn.…, SYStem 
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例 ま #1include <stdio.h> 
ま 1nclude <dir.h> 


main() 
t 
char *pi 


p = searchpath("TLTNK.EXE*): 
printf("Search for TLINK.EXE : Zs\n*。Dp)i 


p = searchpath( "NOTEXTST.FTL* ): 
PrintE("Search for NOTEXTST.PTL : XeWn'。 p): 


プロ グラ ム 出 力 


Search For TLINK.EXE : C:\BTNWTLTNK.EXE 
Search for NOTEXTST.FTL : (nu11) 
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segread 


機能 セグ メン トレ ジス タ を 読み 出し ます 。 


形式 #include <dos.h> 
void segread(struct SREGS * segp) : 


プロ ト タ イ プ dosh 


解説 gegread は 、 セグメント レジ スタ の 現在 の 値 を 、 segp が 指す 構造 体 の 中 に 
格納 し ます 。 こ れ は , intdosx や int86x と と も に 使用 する 目的 で 呼び 出さ 
れ ま す 。 

戻り 値 あり ませ ん 。 

可 搬性 segread は 80x86 フ ァ ミ リィ の プロ セッ サ に 特有 の 関数 で す 。 


関連 項目 FP_OFF, intdos, int86, MK _FP、 movedata 
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setblock 


機能 以前 に 割り 当て られ た プロ ッ ク の 大 き さ を 変更 し ます 。 

形式 int setblock (unsigned segx, unsigned zewsze) ・ 

プロ ト タ イ プ dosh 

解脱 setblock は 、 メ モリ セグ メン ト の 大 き さ を 変更 し ます 。seg* に は 。 以前 の 
allocmem の 呼び 出し で 返さ れ た セグ メン ト ア ドレ ス を 指定 し ます 。 zews- 


ge に は , 新た に 要求 する メモ リ 量 を パラ グラ フ 単 位 で 与え ます 。 


戻り 値 setblock は , 成功 し た 場合 に は -1 を 返し ます 。 エ ラー の 場合 は 確保 可能 な 
最大 の プロ ッ ク サ イズ を 返し , goserrzo を セッ ト し ます 。 


可 搬性 setblock は MS-DOS に 特有 の 関数 で す 。 


関連 項目 allocmem 
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形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


スト リー ム に バッ ファ リン グ を 割り 当て ます 。 


#include <stdio.h> 
void setbuf(FILE * seg, char * 7) : 


stdio.h 


setbuf は 、 自動 的 に 割り 当て られ た バッ ファ に か えて , バッ ファ 7 を 1/ 
O ひ ベッ ファ リン グ に 使用 で きる よう に し ます 。 こ の バッ ファ は , seg7z を 
オー プン し た 後 で 使用 まれ ます 。 

7 が NULL の 場合 は , 1/O は バッ ファ リン グ さ れ ま せん 。 それ 以外 の 場 
合 は 完全 に バッ ファ リン グ さ れ ま す 。 ベ バッ ファ の 大 き さ は BUFSIZ(stdio. 
h の 中 で 定義 きれ て いる ) バイ ト な けれ ば な り ま せん 。 

sg と sdo47 は 、 リダイレクト され て いな けれ ば バッ ファ リン グ さ れ ま 
せん 。 そ う で な い 場 合 は 完全 に バッ ファ リン グ さ れ ま す 。setbuf は , 使用 
きれ る バッ ファ リン グ の 形式 を 変更 する た め に も 使え ます 。 

バッ ファ リン グ を し な い 場 合 , スト リー ム に 文字 を 書き 出す と , すでに フ 
ァイル や デバ イス に 出力 され ます 。 バ ッ フ ァ リ ング する 場合 は , 文字 は バ 
ッ フ ァ に 蓄え られ , プロ ッ ク 単 位 で 書か れ て いき ます 。 

setbuf は 、s/egyn を オー プン し た 直後 、 あ る い は fseek を 呼び 出し た 直後 
以外 に 呼び 出す と 予期 で き な い 結 果 が 生 し ます 。 syeg を バッ ファ リン グ 
し な いと 指定 し た 後 で setbuf を 呼び 出す の は 正当 で あり 問題 は 起こ り ま 
せん 。 

よく 起こ る エラ ー の 原因 と し て 、 バッ ファ を 自動 (ロー カル ) 変数 に 割り 
当て て し まう こと が あり ます 。 バ ッ フ ァ が 宣言 され た 関数 か ら 戻る 前 に , 
ファ イル を クロ ー ズ する の を 忘れ て し まう こと が 多い の で す 。 


あり ませ ん 。 


setbuf は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 
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関連 項目 fflush, fopen, fseek, setybuf 


例 setybuf を 参照 し て くだ さい 。 
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setcbrk 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 


コン トロ ー ル プレ ー ク の 設定 を セッ ト し ます 。 


int setcbrk(int cvg/we) ・ 


dos.h 


setcbrk は 、DOS シス テム コー ル 0x33 を 使っ て ,。 コ ント ロー ルプ レー クチ 
ェ ッ ク を オン また は オフ に 設定 し ます 。 


cyg/we 王 0 オフ に する (コン ソー ル , プリ ンタ , 通信 デバ イス の 
1/O に お いて の み チ ェ ッ ク を 行ない ます )。 
c の yyg/ee 王 1 オン に する (すべ て の シス テム コー ル に お いて チェ ッ 
ク を 行ない ます )。 
setcbrk は , 渡さ れ た 値 c み yg/we を 返し ます 。 


setcbrk は MS.DOS に 特有 の 関数 で す 。 


getcbrk 
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setdate 
機能 DOS の 日 付 を セッ ト し ます 。 
形式 #include <dos.h> 
void setdate(struct date * 27ep) : 
プロ ト タ イ プ dosh 
解脱 setdate は , dg7ep が 指す date 構造 体 の 中 に 入っ て いる 日 付 を , シ ステ ム の 
日 付 (月 , 日 、 年 ) に セッ ト し ます 。 
date 構造 体 は 次 の よう に 定義 され て いま す 。 
struct date 
int da /* 年 */ 
char da_dayi (た 欄 - 明 7』 
char da_moni /* 月 4/ 
})j 
戻り 値 あり ませ ん 。 
可 折 性 setdate は MS-DOS に 特有 の 関数 で す 。 
関連 項目 getdate, gettime, settime 
例 getdate を 参照 し て くだ さい 。 
360 
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setdisk 


機能 カレ ント ディ スク ドラ イプ を セッ ト し ます 。 


形式 int setdisk(int み ye) ・ 


プロ ト タ イ プ dirh 


解説 setdisk は 、 カ レン トド ライ ブ を の ze に 指定 され た も の に し ます (0=A, 
1=B, 2=C)。DOS シス テム コー ル 0Ox0E と 同じ で す 。 


戻り 値 setdisk は , 利用 可能 な ドラ イブ の 総数 を 返し ます 。 


可 搬性 setdisk は MS-DOS に 特有 な 関数 で す 。 


関連 項目 getdisk 
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setdta 


形式 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬性 
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ディ スク 転送 アド レス を セッ ト し ます 。 


void setdta (char far * go) : 


dos.h 


setdta は 、 ディ スク 転送 アド レス (DTA) の 現在 の 設定 を , 9g に 指定 さ 
れ た 値 に 変更 し ます 。 


あり ませ ん 。 


setdta は MS-DOS に 特有 の も の で す 。 


getdta 
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setftime 


機能 ファ イル の 日 付 と 時 刻 を セッ ト し ます 。 


形式 #include <io.h> 
int setftime(int gzg/e, struct ftime * 7 が 77ep) : 


プロ ト タ イ プ ioh 


解説 setftime は 、 オー プン され て いる 4gzgfe に 結び つけ られ て いる ディ スク 
ファ イル の ファ イル 時 刻 ・ 日 付 に , 7zzep が 指す ftime 構造 体 に 格納 され 
て いる 日 付 ・ 時 刻 を セッ ト し ます 。 
ftime 構造 体 は 次 の よう に 定義 され て いま す 。 


struct ftlme 人 


unstgned ft tseci 5: /* 秒 (2 秒 単位 ) */ 
unstgned ft mini 6i /* 分 ォ / 
uneigned ft houri 5』 /* 時 ォ / 
unelgned ft dayi 5: /* 日 */ 
unsigned ft month: 4i /* 月 */ 
unsigned ft yeari 7: /* 年 一 1980 */ 
5 
戻り 値 成功 し た 場合 , setftime は 0 を 返し ます 。 


エラ ー の 場合 は -1 を 返し , eryzzo に 次 の いずれ か を セッ ト し ます 。 


EINFNC 無効 な ファ ンク ショ ン 番 号 
EBADF ファ イル 番号 が 正しく な い 


可 搬性 setftime は MS-DOS に 特有 の 関数 で す 。 


関連 項目 getftime 


例 getdate を 参照 し て くだ さい 。 
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setjmp 


機能 


形式 


プロ ト タ イ プ 


戻り 値 
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ノン ロー カル goto の た め の セ モット アッ プ を 行ない ます 。 


#include <setimp.h> 
int setmpGmp_buf 用 の ) : 


setjmp.h 


setjmp は , 現在 の 完全 な タス ク の 状態 を と ら え て の に 格納 し , 0 を 返し 
ます 。 

setjmp を 行なっ た 後 で 、 その. を 引数 と し て longjmp を 呼び 出す と , 
7 の に 入っ て いた タス ク の 状態 が 回 復 さ れ , setjmp が 値 yz/ を 返し た か 
の よう に リタ ー ン し ます 。 

タス ク の 状態 と は 以下 の も の を いい ます 。 


圏 すべ て の セグ メン トレ ジス タ (CS, DS, ES, SS) 
田 レ ジス クタ 変数 (SI、DI) 

圏 ス タッ ク ポ イン タ (SP) 

田 フ レー ムペ ー ス ポイ ンタ (BP) 

圏 フラ グ 


タス ク の 状態 は 、 コル ー チ ン を 実現 する た め に setjmp が 使用 され る の に 
充分 な も の で す 。 

setimp は , longjmp より 前 に 呼び 出し て お か な けれ ば な り ま せん 。setjmp 
を 呼ん で pp を 設定 し た ルー チン は , longjmp が 呼び 出さ れる まで は ア 
クティ プ な まま で な けれ ば な ら ず , リタ ー ン する こと は で きま せん 。 もし, 
そう し て し まっ た 場合 は 、 結果 は 子 測 で きま せん 。 

setjmp は , プロ グラ ム の 低 レ ベル サブ ルー チン に お いて 起こ る エラ ー や 例 
外 を 処理 する 際 に 便利 な も の で す 。 


setjmp は , 最初 に 呼び 出さ れ た と き は 0 を 返し ます 。 
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可 搬性 se 人 imp は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 
関連 項目 longjmp, signal 


例 longjmp を 参照 し て くだ さい 。 
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Ssetmem 


機能 ある 男 囲 の メモ リ に 値 を 代入 し ます 。 


形式 Void setmem (void * desr, unsigned /ezg7, char yg/e) : 


プロ ト タ イ プ memh 


解説 setmem は , gdes7 が 指す プロ ッ ク グ の 先頭 か ら ezg7, バイ ト を , yg/we で 埋め 
ます 。 

戻り 値 あり ませ ん 。 

可 搬 性 setmem は 8086 フ ァ ミ リィ に 特有 の 関数 で す 。 

関連 項目 memaet, strset 
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setmode 


機能 オー プン ファ イル の モー ド を セッ ト し ます 。 


形式 #include <fcntl.h> 
int setmode(int 4gzg/e, int Zzzoge) ・ 


プロ ト タ イ プ ioh 

解説 setmode は , gzgde に 結び つけ られ て いる オー プン ファ イル の モー ド を , 
バイ ナリ か テキ スト に セッ ト し ます 。 引 数 zzode は 、O_BINARY か 0O 
TEXT の どちら か の 値 で な けれ ば な り ま せん (これら の シン ポリ ッ ク 定 数 


は fcntl.h の 中 で 定義 きれ て いま す )。 


戻り 値 setmode は , 成功 し た 場合 は 0 を 返し ます 。 エ ラー の 場合 は -1 を 返し , errzo 
に ENIVAL (引数 が 正しく な い ) を セッ ト し ます 。 


可 搬性 setmode は UNIX シス テム で 使用 で きま す 


関連 項目 _creat, creat, open, open 
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settime 


機能 シス テム 時 刻 を セッ ト し ます 。 


形式 #include <dos.h> 


void settime (struct time * 7ziep) : 

プロ ト タ イ プ dosh 

解説 settime は 7 が iep が 指す time 構造 体 の 中 に 入っ て いる 時 刻 を シス テム の 
時 刻 に セッ ト し ます 。 


time 構造 体 は 次 の よう に 定義 8 れ て いま す 。 


struct time 人 


unsigned char t1 mini な 分 */ 
unsigned char t1 houri /* 時 ォ / 
unsigned char t1_hundi /* 1/100 秒 */ 
unstgned char t1 seci /* 秒 */ 
}: 

戻り 値 あり ませ ん 。 

可 搬性 settime は MS-DOS に 特有 の 関数 で す 。 

関連 項目 ctime, getdate, gettime, setdate, time 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


setvbuf 


形式 


プロ ト タ イ プ 


解説 


スト リー ム に バッ ファ リン グ を 割り 当て ます 。 


#include <stdio.h> 
int setvbuf(FILE * segz, char * 7,int の pe size t size) ・ 


stdio.h 


setvbuf は , 自動 的 に 割り 当て られ る バッ ファ に か えて , バッ ファ が が を 
1/O バ ベッ ファ リン グ に 使用 で きる よう に し ます 。 こ の バッ ファ は , stream 
を オー プン し た 後 で 使用 で きる よう に な り ま す 。 

の が NULL の 場合 は 、 バ ッ フ ァ は malloc を 使っ て 確保 され ます 。 バ ッ 
ファ に 確保 きれ る 領域 の 大 き さ と し て sze が 使わ れ ま す 。 引 数 sze は パッ 
ファ の 大 き さ を 指定 する も の で あり , ゼロ より 大 きく な けれ ば な り ま せん 。 


注意 : sze の 最大 値 は 32767 に 制限 され ます 。 


gz と sdo47 は 、 リ ダイ レク ト さ れ て いな けれ ば バッ ファ リン グ さ れ ま 
せん 。 そう でない 場合 は 完全 に バッ ファ リン グ さ れ ま す 。 

バッ ファ リン グ を し な い 場 合 、 ス トリ ー ム に 文字 を 書き 出す と ,。 すぐ に フ 
ァイル や デバ イス に 出力 され ます 。 バ ッ フ ァ リ ング する 場合 は , 文字 は バ 
ッ フ ァ に 蓄え られ , プ ブロック 単位 で 書か れ て いき ます 。 

引数 pe は 次 の いずれ か で す 。 


_IOFBF ファ イル は 完全 に バッ ファ リン グ さ れ ま す 。 つ まり , 入力 操 
作 は バッ ファ が いっ ぱい に な る まで 行なわ れ ま す 。 出 力 で は 。 
バッ ファ が 完全 に いっ ぱい に な る まで ファ イル に 書き 出さ れ 
ませ ん 。 

_IOLBF ファ イル は 行 バ ッ フ ァ リ ング され ます 。 入 力 操作 は , 上 と 同 
様 に バッ ファ が いっ ぱい に な る まで 行なわ れ ま す 。 出 力 で は . 
復 改 文字 が 書か れ た と き に バッ ファ が フラ ッシュ され ます 。 
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_IONBF ファ イル は バッ ファ リン グ さ れ ま せん 。 ゲ と sge 引数 は 無 
視 さ れ ま す 。 各 入力 操作 は ファ イル か ら 直 接 行 な われ ます 。 
出力 も , デー タ が 書か れる と すぐ に ファ イル に 書き 出さ れ ま 
す 。 


よく 起こ る エラ ー の 原因 と し て , バッ ファ を 自動 (ロー カル ) 変数 に 割り 
当て て し まう こと が あり ます 。 バ ッ フ ァ が 宣言 され た 関数 か ら 戻 る 前 に , 
ファ イル を クロ ー ズ する の を 忘れ て し まう こと が 多い の で す 。 

戻り 値 setybuf は , 成功 し た 場合 は 0 を 返し ます 。 の pe と sze に 正しく な い 値 を 与 
えた 場合 、 お よび バッ ファ を 確保 する た め の 充 分 な 領域 が な か っ た 場合 に 
は , 0 以外 の 値 を 返し ます 。 

可 搬 性 setybuf は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 


関連 項目 fflush, fopen, setbuf 
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すま 1nclude <etdlo.h> 


maln() 


{ 


FTLE *1nput。 *outputi 
char bufr[512]: 


1nput = fopen(*E11e.in*。・ 
output = fopen("E11e.out 


/* 最小 限 の ディ スク アク セス 用 の スト リー ム を セッ ト ア ッ プ . 

専用 の 文字 バッ ファ を 使う . ト 74 
1f (setvbuf(1nput。 bufr。 TOPBP。 512) != 0) 

printE("fa11ed to set up buffer Eor 1nput fi1e\n')i 
el1se 

printf(*"buffer set up for 1nput flewn*): 


/* 出 カ スト リー ム を セッ ト ア ッ プ .ma11oc を 間接 的 に 呼び 出し て 
確保 し た 領域 を 使っ て 行 バ ッ フ ァ リ ング を 行なう . 7 
1f (setvbuf(output。 NOLL, TOLBF。132) != 0) 
printf("fat1ed to set up buffer for output f11e\n'): 
else 
printf(*buffer set up for output f11e\n'): 


/* ここ で ファ イル エ /0 を 行なう */ 
/* ファ イル を クロ ー ズ する */ 


fc1ose(1nput) 
fc1ome(output ) : 
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setvect 

機能 割り 込み ベク タ エ ン トリ を セッ ト し ます 。 

形式 void setvect(int eyyP/ が の , VOid interruDt (* ネ が /) () ) : 

プロ ト タ イ プ dosh 

解脱 8086 フ ァ ミ リィ の すべ て の プロ セッ サ は 割り 込み ベク タ の セッ ト を 持っ て 
お り , これ に は 0 一 255 の 番号 が ふら れ て いま す 。 各 ベ クタ の 中 の 4 バイ ト 値 
は , 割り 込み 関数 が 置か れ て いる 場所 を 示す アド レス で す 。 
setvect は , 7277 の PO で 指定 され た ベク タ の 値 に , 新しい 値 を セッ ト し 
ます 。 太 は , 新しい 割り 込み 関数 の アド レス を 含む far ポイ ンタ で す 。C の 
ルー チン を interrupt ルー チン と 宣言 し て いる 場合 に は 、/y に 渡せ る の は 
その ルー チン の アド レス だ け に な り ま す 。 

: dos.h で 宣言 され て いる プロ ト タイ プ を 使え ば , どの メモ リモ デル 

に お いて も , 割り 込み 関数 の アド レス を setvect に 渡す こと が で きま す 。 

戻り 値 あり ませ ん 。 

可 搬 性 setvect は 8086 フ ァ ミ リィ の プロ セッ サ に 特有 の 関数 で す 。 

関連 項目 getvect 
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setverify 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬 性 


関連 項目 


べ リ ファイ フラ グ の 状態 を セッ ト し ます 。 


void setverify (int yg/e) ・ 


dos.h 


setverify は ,、 ベリ ファ イフ ラグ の 状態 を we/we に セッ ト し ます 。 


yg/e 三 


! 
に 23 


べ ベリ ファ イフ ラグ オフ 


yg/e べ ベリ ファ イフ ラグ オン 


べり ファ イフ ラグ は ディ スク へ の 出力 を 制御 し ます 。 ベ リフ ァ イ が オフ の 
と き に は 書き 込み の 照合 (ベリ ファ イ ) は 行なわ れず , ベリ ファ イ が オン 
の と き は すべ て の ディ スク へ の 書き 込み に お いて , デー タ が 適切 に 書き 出 
され た か どう か を 確か め る た め に 照合 が 行なわ れ ま す 。 

あり ませ ん 。 


setverify は MS-DOS に 特有 の 関数 で す 。 


getverify 
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プロ ト タ イ プ 
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シグ ナル 処理 操作 を 指定 し ます 。 


#include <Signal.h> 
Void (* signal(int sig, void(* 7zzc) (int sg[,int s の coge] ) ) ) (int) ・ 


signal.h 


signal は 、 シグ ナル 番号 sjg が 受け 取ら れ た 後 で どの よう に 処理 され る か 
を 決定 し ます 。 ユ ー ザ 指定 の ハン ドラ ルー チン を イン スト ー ル する こと も 
で き 、 signal.h の 中 で あら か じ め 定 義 き され て いる 2 個 の ハン ドラ の いずれ か 
を 使う こと も で きま す 。 

2 つの 定義 済み ハン ドラ は 次 の 通り で す 。 


関数 ポインタ 意味 


SIG_DFL プロ グラ ム を 終了 する 。 
SIG_IGN この 型 の シグ ナル は 無視 する 。 


signal.h の 中 で 定義 され て いる 3 番目 の 定義 済み ハン ドラ は SIG_ERR で 
す 。 こ れ は , signal か ら の エラ ー 戻 り を 示す た め に 使わ れ ま す 。 
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シグ ナル 型 お よび その デフ ォ ル ト 値 は 次 の 通り です 。 


シグ ナル 型 。 意味 


SIGABRT 異常 終了 。 デ フォ ルト 動作 は _exit(3) の 呼び 出し と 同じ 。 
SIGFPE ゼロ 除算 な どの 正しく な い 操 作 に よっ て 引き 起こ され た 
数 学 的 な エラ ー。 デ フォ ルト 動作 は _exit(1) の 呼び 出し 


と 同じ 。 

SIGILL 不当 な 操作 。 デ フォ ルト 動作 は _exit(1) の 呼び 出し と 同 
じ 。 

SIGINT C7RL-C 割り 込み 。 デ フォ ルト 動作 は INT 23H の 実行 。 

SIGSEGV 主 記憶 へ の 不当 な アク セス 。 デ フォ ルト 動作 は _exit (1) 
の 呼び 出し と 同じ 。 

SICTERM プロ グラ ム 終 了 要 求 。 ア フォ ルト 動作 は _exit(1) の 呼び 
出し と 同じ 。 


signalh は , sg_g7o7xic 7 と いう 型 を 定義 し て いま す 。 これ は , 非同期 の 割 
り 込 み の 存在 下 で アト ム 的 に プロ モッ サ が ロー ド や セー プ す る こと が で き 
る 最大 の 整数 型 で す (8086 フ ァ ミ リィ で は , これ は 16 ビ ッ ト ワ ー ド , す な 
わ ち Turbo C の 整数 ) 。 

raise 関数 , あ る い は 外部 イベ ント に よっ て シグ ナル が 生成 され た 場合 , 以 
下 の こ と が 行なわ れ ま す 。 


1. その シグ ナル に 対し て ユー ザ 指 定 の ハン ドラ が イン スト ー ル され て い 
れ ば , その シグ ナル 型 に 対す る 動作 が SIG_DFL に セッ ト さ れ ま す 。 
2. ユー ザ 指 定 の 関数 が , シグ ナル 型 を 引数 と し て 呼び 出さ れ ま す 。 


ユー ザ 指 定 の ハン ドラ 関数 は 、return 文 や abort, exit, exit, longjmp の 
呼び 出し で 終了 する こと が で きま す 。 
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Turbo C は , シグ ナル 型 が SIGFPE, SIGSEGV, SIGILL の 場合 に は , 
ANSI C へ の 拡張 を イン プリ メン ト し て いま す 。 ユ ー ザ 指定 の ハン ドラ 関 
数 は , 引数 を 1 つ あ る い は 2 つ 追 加 し て 呼び 出さ れ ま す 。 raise 関数 を 明示 的 
に 呼び 出し た 結果 と し て 、 SIGFPE, SIGSEGV, SIGILL の いずれ か が 発行 
きれ た 場合 , ユー ザ 指 定 の ハン ドラ 関数 は , その ハン ドラ が 明示 的 に 呼び 
出さ きれ て いる こと を 示す 整数 値 を 追加 引数 と し て 呼び 出さ れ ま す 。SIG- 
FPE, SIGSEGV, SIGILL に 対す る 明示 的 呼び 出し の 値 は 交 の よう に な っ 
て いま す (float.h の 中 の 宣言 を 参照 し て くだ さい )。 


シグ ナル 型 起動 値 

SIGFPE FPE_ EXPLICITGEN 
SIGSEGV SEGV_ EXPLICITGEN 
SIGILL ILL EXPLICITGEN 


SIGFPE が 浮動 小数 点 例外 に よっ て 発行 され た 場合 , ユー ザ ハ ンド ラ は , 
その シグ ナル の FPE_xxx 型 を 示す 追加 引数 を と も な っ て 呼び 出さ れ ま す 。 
プロ セッ サ 例 外 の 結果 と し て 、 SIGSEGV, SIGILL,、 あるいは SIGFPE シ 
グ ナ ル の 変種 (FPE INTOVFLOW また は FPE INTDIVO) が 引き 起こ さき 
れ た 場合 に は , ユ ー ザ ハン ドラ は 2 つの 追加 引数 を と も な っ て 呼び 出さ れ ま 
k 3 


1. SIGFPE,、 SIGSEGV、 あ る い は SIGILL の 例外 型 ( こ れ ら の 型 に つ 
いて は float.h を 参照 し て くだ さい )。 こ の 最初 の 引数 は 通常 の 
ANSI の シグ ナル 型 で す 。 

2. ユー ザ 指 定 の ハン ドラ を 呼び 出し た 割り 込み ペン ドラ の スタ ッ ク の | 
中 を 指す 整数 ポイ ンタ 。 こ の ポイ ンタ は 。 例外 が 発生 し た と き に 退 
避 さ れ た プロ セッ サレ ジス タ の リス ト を 指し ます 。 レ ジス タ は , 割 
り 込 み 関 数 へ の 引数 と 同じ 順序 で 並ん を で いま す 。 つ まり ., BP, DI, SL, 
DS, ES, DX, CX, BX, AX, IP, CS, FLAGS の 順 で す 。 ハ ンド ラ が 
リタ ー ン する と き に レジ スタ の 値 を 変更 し た い 場 合 は 、 こ の リス ト 
に お ける 対応 する 部 分 を 変更 し ます 。 た と えば , SI に 新しい 値 を セ 
ッ ト し た い 場 合 は 大 の よう に な り ま す 。 
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*((nt *)11et_pointer + 2) = new ST value: 


この よう に し て , ハン ドラ は レジ スタ の 値 を 調べ た り , 新しい 値 に 
変更 する こと が で きま す (後に 示す 例 2 を 参照 し て くだ さい )。 


次 に 示す SIGFPE 型 の シグ ナル が 起こ り 得 ます (ある い は 生成 され 得 ま 
す )。 こ れ ら は , メイ ン CPU に お ける "INTEGER DIVIDE BY ZERO', 
"INTERRUPT ON OVERFLOW" に 加え て , 80x87 が 検出 する こと が で 
きる 例外 に も 対応 し て いま す 。 こ れ ら の 宣言 は float.h の 中 に あり ます 。 


SIGFPE シグ ナル 意味 


FPE INTOVFLOW OF フラ グ を セッ ト し て INTO 命令 を 実行 
FPE INTDIV0 ゼロ に よる 整数 の 除算 

FPE INVALID 不当 な 操作 

FPE ZERODIVIDE ゼロ に よる 除算 

FPE OVERFLOW 数 値 オ ー バ ー フ ロー 

FPE UNDERFLOW 数 値 ア ンダ ー フ ロー 

FPE INEXACT 精度 

FPE_ EXPLICITGEN ユー ザ プ ロ グラ ム が raise(SIGFPE) を 実行 


注意 : FPE INTOVFLOW と FPE INTDIVO0 シ グ ナ ル は , 整数 に 対す る 
操作 に よっ て 生成 され ます 。 そ の 他 は 浮動 小数 点 に 対す る 操作 に よっ て 生 
成 され ます 。 浮 動 小数 点 例外 が 生成 され る か どう か は , コ プ ロ セッ サ 制 御 
ワー ド に 依存 し ます 。 コ プ ロ モッ サ 制 御 ワ ー ド は _control87 を 使っ て 変更 
する こと が で きま す 。 デ ノー マル (不正 規 化 数 ) 例外 は TurboC に よっ て 
処理 きれ, シグ ナル ハン ドラ に は 渡さ きれ ませ ん 。 


天 の SIGSEGV 型 の シグ ナル が 起こ り 得 ます 。 


SIGSEGV シグ ナル 意味 


SEGV_BOUND bound コン スト レイ ント 例外 
SEGV_EXPLICITGEN raise (SIGSEGV) が 実行 され た 


注意 : 8088 お よび 8086 プ ロモ ッ サ は bound 命令 を 備 そ て いま せん 。 80186/ 
286/386、 お よび NEC の V シ リー ズ の プロ セッ サ は この 命令 を 持っ て い 
ます 。 し た が っ て , 8088 お よび 8086 プ ロ セ モッ サ で は , SIGSEGV シグ ナル の 
SEGV_BOUND 型 は 起こ り 得 ま せん 。 Turbo C は bound 命令 を 生成 し ま 
せん が , イン ライ ンコ ー ド や 独立 に アセ ンプ ブル され リン ク さ れる アセ ンプ 
リ 言 語 ル シー チン の 中 で は 使用 され 得 ます 。 


次 の SIGILL 型 の シグ ナル が 起こ り 得 ます 。 


SIGILL シグ ナル 意味 


ILL EXECUTION 不当 な 操作 が 試み られ た 
ILL EXPICITGEN raise (SIGILL) が 実行 され た 


注意 : 8088,、 8086、 V20, V30 プ ロモ セッ サ は 不当 操作 例外 を も っ て いま せ 
ん 。186, 286, 386, V40, V50 プ ロモ セッ サ は この 例外 型 を 持っ て いま す 。 
し た が っ て , 8088. 8086. V20, V30 プ ロモ セッ サ で は SIGILL シグ ナル の ILL 
EXECUTION 型 は 起こ り 得 ませ ん 。 
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戻り 値 


可 搬性 


関連 項目 


例 1 


注意 : シグ ナル 型 が SIGFPE, SIGSEGV、SIGILL の 場合 は , 8087 の 状態 
が 正しく な く な っ て いる , 整数 除算 の 結果 が 間違っ て いる , オー バー フロ 
ー す べき で な い 操作 が 行わ れ た , bound 命令 が 失敗 し た , 不当 な 操作 が 行 
な われ た な どの いずれ か で ある の で , シグ ナル ハン ドラ か ら 戻 る こと は 一 
般 に 望ま し いも の で は あり ませ ん 。 唯 一 の 例外 は ,、 ハン ドラ が レジ スタ を 
変更 し て 理 に か な っ た リタ ー ン の 状況 が 作り 出さ れる か , シグ ナル 型 が そ 
の シグ ナル は 明示 的 に 生成 され た も の で ある こと を 示し て いる 場合 で す 

( 例 : FPE EXPLICITGEN、SEGV_EXPLICITGEN. ILL_ 
EXPLICITGEN)。 一 般 に この よう な 場合 は , エラ ー メ ッ セ ー ジ を 表示 し , 
exit。 exit, abort を 使用 し て , プロ グラ ム を 終了 させ る の が 良い で し ょ 
う 。 そ う で な い 場 合 は 、 プ ログ ラム 続行 の 際 に どの よう な 事態 に な る か は 
了 予想 が で きま せん 。 


呼び 出し が 成功 し た 場合 , signal は , 指定 され た シグ ナル 型 に 対す る ハン 
ドラ ルー チン を 指す ポイ ンタ を 返し ます 。 呼 び 出し が 失敗 し た 場合 は SIG 
ERR を 返し , eryzo に EINVAL を セット し ます 。 


signal は ANSI C と 互換 性 が あり ます 。 


abort。 control87、 ctrlbrk, exit、 longjump、 raise, setjmp 


/* この 例 で は , シグ ナル ハン ドラ ルー チン を , CTRL-C が 押さ れ た と き に 
実行 され る よう に イン スト ー ル し ます . */ 


#include <stdio.h> 
#include <signal1 .h> 


void Catcher(int sig) 


Printf("\nNow in break routine\n*): 
exit(1): 
} 


main() 
( 
signa1(STGTNT Catcher): 
for(i) 
PrintE("\nTn main() Programe\n* ): 
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例 2 /* この 例 で は , SIGEPE の た め の シ グ ナ ル ハン ドラ ルー チン を イン スト ー ル し , 
整数 の オー バー フロ ー 条 件 を と ら え , 調整 値 を AX に セッ ト し て , 
リタ ー ン し ます . */ 


#pragma in1ine 
お ncude <stdio.h> 
太 nc1ude <signa1.h> 


Yoid Catcher(int sg, nt type, 1nt *reg11st) 
{ 

printf("Caught itIWn"): 

*(reg1ist+8) = 3: /* AX に 3 を 返す */ 
} 


matn() 
6 
signa1(STGFPE, Catcher): 


aSm mov ax, 07FFFH /* AX = 32767 */ 
asm inc ax /* オー バー フロ ー を 起こ す +*/ 
asm into /* ハン ドラ を アク ティ ブ に する +*/ 


/* ハン ドラ は AX に 3 を 返す . それ が 起こ ら な けれ ば , dec 命令 の 後 の 
1nto が 実行 され た と き に , 他 の 例外 が 発生 する */ 


aSm dec ax /* オー バー フロ ー な し */ 
asm into /* ハン ドラ は アク ティ ブ に な ら な い */ 
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機能 正弦 を 求め ます 。 


形式 #include <math.h> 
double sin(double *) : 


プロ ト タ イ プ mathh 


解説 sin は , 入力 値 の 正弦 (サイ ン ) を 計算 し ます 。 角 度 x は ラジ アン 単位 で 指 
定 し ます 。 
戻り 値 sin は 、 入力 値 の 正弦 を -1 一 1 の 範囲 返し ます 。 


sin の エラ ー 処 理 は 、 matherr を 使っ て 変更 する こと が で きま す 。 


可 搬性 sin は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 


関連 項目 acos, asin, atan, atan2, cos, cosh, tan, tanh 
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sinh 

機能 双曲線 正弦 を 求め ます 。 

形式 #include <math.h> 
double sinh (double *) : 

プロ ト タ イ プ mathh 

解説 sinh は , 実 数 の 引数 の 双曲線 正弦 (ハイ バボ ポリ ッ ク サ イン ) を 計算 し ま 
す 。 

戻り 値 simh は 、* の 双曲線 正弦 を 返し ます 。 
計算 結果 が オー バー フロ ー す る 場合 は , sinh は 適切 を 符号 の HUGE_VAL 
を 返し ます 。 
sinh の エラ ー 処 理 は , matherr 関数 で 変更 する こと が で きま す 。 

可 搬性 sinh は UNIX シス テム て で 使用 で き , ANSI C と 互換 性 が あり ます 。 

関連 項目 acos, asin, atan, atan2, cos, cosh, sin, tan, tanh 
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機能 実行 を 一 定時 間 停止 し ます 。 

形式 void sleep (unsigned secozg の s) : 

プロ ト タ イ プ dos.h 

解説 sleep を 呼び 出す と , 現在 実行 中 の プロ グラ ム は , 引数 secon の 5 に 指定 され 
た 秒 数 だ け 実 行 を 停止 し ます 。 停 止 時 間 は , PC-9801 で は DOS の クロ ッ 
ク 、IBM PC で は 1/100 秒 単位 の 近似 値 に な り ま す 。 

戻り 値 あり ませ ん 。 


可 搬性 sleep は UNIX シス テム で 使用 で きま す 。 


関連 項目 delay 
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機能 シェ アド ファ イル を オー プン し ます 。 


形式 #include <fcntl.h> 
#include <sys\stat.h> 
#include <share.h> 
#include <io.h> 
int sopen(char * pg が int gccess, int s772g, int 7zoge) : 


プロ ト タ イ プ ioh 


解説 sopen は , /g77 に 指定 し され た ファ イル を , gccess, sg, お よび zzode の 
値 に し た が っ て , 読み 出し , 書き 込み 、 あ るい は 両用 の シェ アド ファ イル 
を し で オー プン ジン し ます 。 
sopen は マク ロ と し て 次 の よう に 定義 され て いま す 。 


open(path, (access) | (shf1ag ) , mode ) 


引数 zceesy は , 次 に 示す 2 つの リス ト の フラ グ を ビッ ト ご と に OR する こ 
と に よっ て 作り ます 。 リ スト 1 か ら は 1 つの フラ グ し か 選べ ませ ん 。 リ スト 
2 で は , 複数 の フラ グ を 組み 合わ せる こと が で きま す 。 


リス ト 1 : 読み 出し / 書 き 込み フラ グ 
O_RDONLY 読み 出し 専用 と し て オー プン 
O_WRONLY 書き 込み 専用 と し て オー プン 
O_RDWR 読み 出し お よび 書き 込み 用 と し て オー プン 
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リス ト 2 : 他 の アク セス フラ グ 

O_NDELAY 使用 され ませ ん 。UNIX と の コン パチ ビリ ティ を 図る 
た め の も の で す 。 

O_APPEND これ が セッ ト さ れ て いる と , ファ イル ポイ ンタ は まず 
ファ イル の 終わ り に 位置 づけ られ ます 。 

0 CREAT 指定 の ファ イル が すでに 存在 し て いれ ば , この フラ グ 
は 意味 を 持ち ませ ん 。 存 在 し て いな けれ ば , ファ イル 
は 新規 に 作成 され 、 zzode の ビッ ト は chmod の 場合 と 
同様 に し て , 必 性 ビッ ト に セット され ます 。 

O_TRUNC ファ イル が 存在 し て いる 場合 は , その 長 さ は 0 に 削ら れ 
ます 。 フ ァイル 必 性 は その まま で 変化 し ませ ん 。 


O_EXCL 使用 きれ ませ ん 。UNIX と の コン パチ ビリ ティ を 図る 
た め の も の で す 。 

O_BINARY この フラ グ は , 明示 的 に バイ ナリ モー ド で ファ イル を 
オー プン する こと を 示す の に 使用 され ます 。 

O_TEXT この フラ グ は , 明示 的 に テキ スト モー ド で ファ イル を 


オー プン する こと を 示す の に 使用 され ます 。 


これ ら の 0 ..… シ ン ポ リッ ク 定 数 は , fcntl.h の 中 で 定義 され て いま す 。 
O_BINARY も 0O_TEXT も 与え られ て いな い 場 合 は , ファ イル は , グロ ー 
バル 変数 7zode に セッ ト され て いる 変換 モー ド で オー プン され ます 。 
O_CREATE フ ラグ が gccess を 作る た め に 使わ れ て いる 場合 は , 引数 
ode を 次 に 示す シン ポリ ッ ク 定 数 か ら 作る 必要 が あり ます 。 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


oge の 値 アク セス 許可 
SIWRITE 書き 込み 可 
S_IREAD 読み 出し 可 


S_IREAD | S IWRITE 読み 書き 可 
ーー ニーーーーーー ニ ーー ーーー ーー ーー 
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引数 %7g に は ,、 ファ イル 7g 放 に 対し て 許可 され る ファ イル シェ アリ ン 
グモ ー ド を 指定 し ます 。 以下 の 定数 が share.h の 中 で 定義 る され て いま す 。 


s ん 7g の 値 意味 
SH_COMPACT コン バチ プル モー ド を セッ ト す る 
SH_DENYRW 読み 出し , 書き 込み アク セス と も に 不可 
SH_DENYWR 書き 込み アク セス 不可 
SH_DENYRD 読み 出し アク セス 不可 
SH_DENYNONE 読み 出し 書き 込み アク セス と も に 許可 
SH_DENYNO 読み 出し , 書き 込み アク セス と も に 許可 

戻り 値 成功 する と sopen は 負 で な い 整 数 (ファ イル ハン ドル ) を 返し ,、 ファ イル 


の 現在 位置 を 示す ファ イル ポイ ンタ を ファ イル の 先頭 に 置き ます 。 エ ラー 
の 場合 は -1 を 返し , errzo に 次 の いずれ か の 値 を セッ ト し ます 。 


ENOENT バス 名 また は ファ イル 名 が 見 つか ら な か っ た 
EMFILE オー プン され て いる ファ イル が 多 す ぎる 
EACCESS アク セス が 拒否 され た 
EINVACC アク セス コー ド が 正しく な い 
可 搬性 sopen は UNIX シス テム て で 使用 可能 で す 。UNIX バー ジョ ン 7 で は , O 型 


の ニー モニ ッ ク は 定義 きれ て いま せん 。 UNIX シス テム III は, O BINAR- 
Y を 除く すべ て の O 型 ニ ー モ ニッ ク を 使用 し て いま す 。 


関連 項目 chmod, close, creat, lock, lseek、 open, open, unlock 
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sound (PC-9801) 


形式 


プロ ト タ イ プ 


機能 説明 


ビー プ 音 の 波形 を 指定 し ます 。 
unsigned int sound (unsigned eezcy) ・ 


dos.h 


sound は , ビー ブ 音 の 波 の 間隔 (周期 ) exezcy を 指定 し ます 。 実 際 に 音 
を 発生 する の は beep に よっ て 行ない ます 。 

beep は 、 指定 し た 繰り 返し 回 数 ze だ け 波 を 発生 し ます 。 この と き , 波 の 
間隔 /7egxezcy と , 繰り 返し 回 数 yie の 関係 は 次 の よう に な り ま す 。 


太 e 回 数 
1 周期 
beep オン 


beep オフ メ 
exezoy 時 間 軸 7 一 と 


し た が っ て , 単位 周期 ニ //egzezcoy メ 2 と な り ま す 。 
た と えば , 定時 間 で 波 の 間隔 (周期 ) を 変え て 音 を 出力 し た いと き は , 次 
の 式 の e を 一 定 に 保つ よう に し て くだ さい 。 


egeezcy ベ が の 6 三 の 


下記 の プロ グラ ム で は , 最初 に 単位 周期 20 で 繰り 返し 回 数 5000 で 比較 的 高 
い 音 が 発生 し , 次 に 単位 周期 1000 で 繰り 返し 回 数 100 で 比較 的 低い 音 が 発生 
し ます 。 と も に 音 の 発生 時 間 は 同じ で す 。 

cyce = 50000i 

Ereq = 10: sound(Ereq): beep(cyce/Ereq):  /* 高い 音 */ 

freq = 500: sound(Ereq): beep(cyce/Ereq):  /* 低い 音 */ 


また , 一 番 高 い 音 は 波 の 間隔 (周期 ) //exezcy を 0 に し た と き で す 。 
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注意 1 : frequency は , 本来 は 周波 数 の 意味 で す が , PC-9801 シ リー ズ で は 
逆数 の 意味 で ある 周期 と し て 扱っ て いま す 。 


注意 2: マシ ン の タイ プ に より , また 基本 クロ ッ ク の 違い に より 音色 が 変 
化す る の で , 各 マ シン に 合わ せ て 調整 し て くだ さい 。 


Bound は, 直前 に 設定 され て いた 波 の 間隔 (周期 ) を 返し ます 。 
この 関数 は PC-9801 シ リー ズ で の みろ 動 作 し ます 。 

beep 

#1nclude <dos.h> 


void beepbeep( ) 
1 


unslgned fi 
f = sound(10): /* 直前 の 値 を 退 可 する */ 
beep(50000 / 10)』 /* 高音 */ 
sound(700)』 
beep(50000 / 700): /* 低い 音 2 
sound(f): /* 以前 の 値 を 復元 する +*/ 
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sound (IBM PC) 


機能 PC の スピ ー カ を 指定 の 周期 で 鳴ら し ます 。 


形式 void sound (unsigned egezcy) : 


プロ ト タ イ プ dosh 


機能 説明 sound は , PC の スピ ー カ を 指定 の 周期 で 鳴ら し ます 。 egzezcy に は 音 の 
周期 を ヘル ツ (回 数 / 秒 ) 単位 で 指定 し ます 。sound に よっ て 鳴り 出し た ス 
ピー カ を 止め る に は 、 mosound を 呼び 出し て くだ さい 。 


戻り 値 あり ませ ん 。 


可 搬性 sound は , IBM PC と その 互換 機 で の み 動作 し ます 。Turbo Pascal に も 
同様 な ルー チン が あり ます 。 


関連 項目 delay、 nosound 


例 /* 7-Hz の 音 を 10 秒 間 発 生 さ せま す ・. 


本 当 の 話 : 7-Hz は , 有 の 頭 募 介 の 中 で 共鳴 する 音 の 周期 で す . 
これ は , オー スト ラリ ア の ある 新しい 工場 で 経験 的 に 得 られ た 

結果 で す . 7-Hz の 音 を 発する その 工場 は 壮 鳴 場 の すぐ 近く に 

位置 し て いま し た が , 工場 の 操業 が 始ま る と , 壮 際 場 の 嶋 が す 

べ て 死ん で し まっ た の で す ・. 


PC に よっ て は , 7-Hz の 音 は 発生 し な いか も し れ ま せん ・. 7 


main() 

{ 
sound(7) : 
delay(10000): 
nosound()』 
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SDaWn.… 


機能 


形式 


プロ ト タ イ プ 
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子 プ ロ セ ス を 生成 し て 実行 し ます 。 


#include <process.h> 
#include <stdio.h> 
int spawnl(int 7 の de, char *※ pg が , char * grgO, grg7, 

-、 の g7, NULL) : 
int spawnle(int oe, char * pg 廊 , char * grg0, grg7, 

.・ 787, NULL, char * ep[]) : 
int spawnlp(int ode, char *※ pg77, Char *※ grg0, g/g7, 

.。 の 7g7, NULL) : 
int spawnlpe(int ode, char * pg が, char * grg0, grg7, 

っ の 87, NULL,char * egy[]) : 

int spawnv(int oge, char ** pg7 が , char * grgy[]) : 
int spawnve(int ode, char * pg 廊 , char 玉 grgy[]、char * ezw[]) : 
int spawnvp(int ode, char * pg が , char * g/gy[]) : 
int spawnvpe(int ode, char * pg が , char * の 7gy[]。 char * ez[]) : 


process.h 


spPaWn… フ ァ ミ リィ の 関数 は , 子 プ ロモ セス を 生成 し て 実行 し ます 。 子 プロ セ 
ス を ロー ド し , 実行 する の に 充分 な メモ リ が 存在 し て いな けれ ば な り ま せ 
ん 。 

oe の 値 は 、spawn.… を 呼び 出し た 後 呼び 出し 関数 ( 親 プ ロ セ ス ) が と 
る 動作 を 指定 する も の で す 。 zoge に 指定 する 値 は 以下 の 3 つ で す 。 


P_ WAIT 子 プ ロ セ ス が 実行 を 終了 する まで 親 プ ロ セ ス を 
一 時 停止 状態 に する 。 

P_NOWAIT 子 プ ロ セ ス の 実行 と 平行 し て 親 プ ロ セ ス も 実行 
を 続け る 。 

P_OVERLAY 親 プ ロ セ ス が 占め て いた メモ リ 領 域 に 子 プ ロ セ 


ス を オー バー レイ する 。 exec.…… 呼 び 出し と 同じ 。 
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注意 : P NOWAIT は 現在 使用 で きま せん 。 使用 する と エラ ー 値 を 発生 し 
ます 。 


pg 太 は 、 呼 び 出さ れる 子 プ ロモ ス の ファ イル 名 で す 。 spawn.… 関 数 を 呼び 
出す と , DOS の 標準 探索 アル ゴリ ズム を 使っ て pg が 探さ れ ます 。 


画 拡 張子 も ピリ オド も な いと き : その 名 前 の ファ イル を 探し ます 。 見 つ 
か ら な いり い 場合 は , .COM を 付加 し て も う 一 度 探し ます 。 そ れ で も 見 つ 
か ら な けれ ば .EXE を 付加 し て も う 一 度 探し ます 。 

画 撤 張子 が 与え られ て いる と き : その 名 前 の ファ イル だ け を 探し ます 。 

田 ビ リオ ド が 与え られ て いる と き : 拡 張子 の な いそ の ファ イル だ け を 探 
し ます 。 

還 spawn.… 関 数 に サフ ィ ッ クス p が つい て いる 場合 2 に ディ レク ト 
リ が 明示 きれ て いな けれ ば , まず カレ ント ディ レク トリ を 探し , 次 に 
DOS の 環境 変数 PATH に 指定 され て いる ディ レク トリ を 探し ます 。 


ファ ミリ イィ 名 spawn の 後に つけ る サフ ィ ッ クス (接尾 辞 ) Lvjp,e は , その 
関数 が どの よう に 動作 する か を 示し て いま す 。 


p DOS の 環境 変数 PATH に 指定 され て いる ディ レク トリ の 中 で 
子 プ ロモ ス を 探し ます 。 た だ し , pg に ディ レク トリ 名 が 含ま れ 
て いる 場合 は そこ を 先 に 探し , 次 に 環境 変数 PATH を 調べ ます 。 
pg に ディ レク トリ 名 が 含ま れ て いな い 場 合 は 、、 カ レン トディ レ 
クト リ を 先 に 探し ます 。p が つか な いり 場合 は , ルー ト と カレ ント デ 
ィ レ クト リ し か 探さ れ ま せん 。 

1 引数 ポイ ンタ grgO, grg7, …。 の g4 は 、 1 つ ず つ 独 立 し た 引数 と し 
て 渡 き れる こと を 意味 し ます 。1 は 通常 , 渡す 引数 の 数 が あら か し 
め わ か っ て いる と き に 指定 し ます 。 


Y 引数 ポイ ンタ grgy[0]、... ggy[z] は , ポイ ンタ の 配列 と し て 
渡さ れる こと を 意味 し ます 。Y は 通常 , 可変 個 の 引数 を 渡す と き に 
指定 し ます 。 


e 引数 ez を 子 プ ロ セ ス に 渡し て , 環境 を 変更 で きる こと を 意味 
し ます 。e が な いり 場 合 は , 子 プ ロモ セス は 親 プ ロ セ ス の 環境 を 受け 継 
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ぎ ま す 。 


SPAaWnN… フ ァ ミ リィ の 各 関 数 は , 引数 の 指定 に 関す る サフ ィ ッ クス (1 また 
は Y) の いずれ か を 含ん で いな けれ ば な り ま せん 。 パス 探索 と 環境 の 受け 継 
ぎ に 関 する サフ ィ ッ クス (p と e@) は オプ ショ ン で す 。 た と えば 次 の よう に 
な り ま す 。 


一 spawnl は , 独立 し た 引数 を と り , ルー ト お よび カレ ント ディ レク トリ 
の 中 で だ け 子 プロ セス を 探し , 親 プ ロ セ ス の 環境 を 子 プ ロ セ ス に 渡す 。 

田 spawnvpe は , 引数 ポイ ンタ の 配列 を と り 、 子 プロ セス を 探す の に 環 
境 変 数 PATH を 使い 、 子 プロ セス の 環境 を 変更 する た め に ezw 引数 
を 受け 入れ る 。 


spDawn… 関 数 は 、 少な く と も 1 つの 引数 (rg0 また は gygy[0]) を 子 プ ロ セ 
ス に 渡さ な く て は な り ま せん 。 慣 例 上 この 引数 は pg で す ( 違 う 値 を 使っ 
て も エラ ー に は な り ま せん ) 。 

DOS 3.0 以 降 で は 子 プ ロモ ス で pg が を 使用 で きま す が , それ より 前 の バー 
ジョ ン で は 子 プ ロ セ ス は 0 番目 の 引数 (grg0 また は の g[0]) の 値 を 使う こ 
と は で きま せん 。 

サフ ィ ッ クス 1 が つい て いる 場合 grg0 は pg を 指し , の g7, …, grg7 は 
新しい 引数 リス ト を 構成 する 文字 列 を 指し ます 。 eg ヵ の 後ろ の NULL は 
リス ト の 最後 で ある こと を 示し ます 。 

サフ ィ ッ クス e が つい て いる 場合 は , 新しい 環境 設定 の リス ト を 引数 ez 
を 通し て 子 プ ロモ ス に 渡す こと が で きま す 。 ez は , char ポイ ンタ の 配列 
で , 次 の よう な 形式 の ヌル 文字 で 終わ る 文字 列 を 指し て いま す 。 


envvar = value 


ezyygr に vg/e が 代入 され ます 。 ezp[] の 最後 の 要素 は NULL で す 。 ez 
[0] が NULL の と き , 子 プ ロ セ ス は 親 プ ロ セ ス の 環境 設定 を 受け 継ぎ ま 
和 9 

@ の g0 十 grg7 十 . 填 の gz( ま た は grgy[0] 十 grgy[1] 十 ... 十 grgy[j) の 合計 
の 長 さ は, 引数 を 区 切る 空白 文字 も 含め て , 127 バ イト 以下 で な けれ ば な り 
ませ ん 。 ヌ ル 文 字 は これ に は 入り ませ ん 。 

spawn.… 関 数 が 呼び 出さ れ た と き に オー プン され て いる ファ イル は , 子 プ 
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ロ セ ス に お いて も オー プン され た まま で す 。 


戻り 値 成功 し た 場合 戻り 値 は 子 プ アロ セ ス の 終了 ステ ー タ ス (正常 終了 の 場合 は 
0) と な り ま す 。 子 プロ セス で exit を 0 以外 の 引数 で 呼び 出せ ば , 終了 ステ 
ー タ ス を 0 以外 の 値 に セン ッ ト す る こと が で きま す 。 
エラ ー の 場合 は , spawn.… 関 数 は -1 を 返し , eryyzo に 次 の いずれ か の 値 を セ 
ト し ます ます 。 


E2BIG 引数 リス ト が 長 す ぎる 

EINVAL 引数 が 正しく な い 

ENOENT バス 名 また は ファ イル 名 が 見 つか ら な い 
ENOEXEC exec フォー マット エラ ー 

ENOMEM メモ リ が 不足 し た 


関連 項目 abort, atexit, exit, exit, exec.… fpreset, searchpath, system 


例 /* SPAWNFAM.C: これ を 実行 する 際 に は , この あと の CHTLD.C を 
・EXE フ ァイル に コン バイ ル し て お いて くだ さい . +*/ 


旭 ncude <etdio.h> 
旭 nc1ude <process.h> 


status(int va1) 
( 
1f (va1 == -1) 
Printf("fai1ed to start chi1d process\n" ) 
else 
1f (va1 > 0) printf(*chi1d terminated abnorma11y\n'): 
} 


/* 次 ペー ジ に つづ く +*/ 
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main() 
16 /* 注意 : 以下 の 環境 文字 列 は 
実行 する マシ ン に 合わ せ て 変更 し て くだ さい ・.*/ 


/* 環境 文字 列 を 作成 する */ 
char *envp[ ] = ( "PATH=A:W"。 
"DUMA4Y=YES" 
3 


/* pathname を 作成 する */ 
Char *pathname = "Ci:WCHTLDRENY\CHTLD .EXE": 


/* 引数 文字 列 を 作成 する */ 
char *args[] = ("CHTLD.EXE*。*1st*。*2nd*。 NULL )i 


Printf("SPAWNL:\n* ): 
status(Spawn1(P_WATT, pathname,args[0], args[1], NULL) ) 


printf("\nSPAWNV:\n*): 
statue(spawnv(P_WATT。 pathname,args) ): 


Printf("\nSPAWNLE:\n* ): 
status(spawnle(P_WATT,。 pathname,args[0], args[1], NULL, envp)): 


PrintE("\nSPAWNVPE:\n* ) 
status(spawnvpe(P_wAIT, pathname,args, enVD) ) 


/* CHTLD.C --- SPAwNEAM.C の た め の 子 プロ セス */ 


#1nclude <etdio.h> 
ま #1nclude <etd1ib.h> 


main(int argc, char *argy[ ]) 
{ 

nt ii 

char *path。 *dunmyi 


path = getenv("PATH* 
dummy = getenv("DUNAY*) 
for (1 = 0: 1 < argci エ オ +) 
printf("argy[Zd] Zs\n'。 1。 argv[1]): 
If (path) 
Printf("PATH = Zswn"。 path): 
1f (dummy) 
Printf("DUMAY = Zs\n"。 dummy ) : 


exit(0): /* 親 プ ロ セ ス に エラ ー コ ー ド 0 を 返す */ 
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SDrintf 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


文字 列 に 書式 つき 出力 を 書き 込み ます 。 


int sprintf(char * 7er, const char * /or7z7 [, の ygz7ze77] ) 


stdio.h 


sprintf は /oryig7 に よっ て 指 さ れ る 書式 文字 列 中 の 書式 指定 を 、 yyzg7 
の 後に 続く 各 引数 に 適用 し , 書式 化 さ きれ た デー タ を 文字 列 * が 477er に 出力 
し ます 。 

sprintf は , 最初 の 書式 指定 を 最初 の 引数 に , 2 つめ の 書式 指定 を 2 つめ の 引 
数 に 、 と いう よう に それ ぞ れ 順番 に 適用 し て いき ます 。 書 式 指定 は , 後に 
続く 引数 と 同じ 数 だ け な け れ ば な り ま せん 。 

* 477er に その 文字 列 を 格納 する 充分 な 領域 が ある か どう か 確認 する の 
は プロ グラ マ の 資 任 で す 。 

書式 指定 を 含む 詳細 な 情報 に つい て は printf の 解説 を 参照 し て くだ さい 。 


sprintf は , 出力 し た バイ ト 数 を 返し ます 。 この バイ ト 数 に は , 最後 の メル 
バイ ト は 含ま れ ま せん 。 エラ ー の 場合 は EOF を 返し ます 。 


sprintf は UNIX シス テム て 使用 で き , ANSIC と 互換 性 が あり ます 。 K& 
R で も 定義 きれ て いま す 。 


fprintf, printf 


printf を 参照 し て くだ さい 。 
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Ssqrt 

機能 正 の 平方 根 を 計算 し ます 。 

形式 #include <math.h> 
double sqrt (double *) : 

プロ ト タ イ プ mathh 

解説 sqrt は , 入力 値 の 正 の 平方 根 を 計算 し ます 。 

戻り 値 成功 し た 場合 sqrt は, 計算 結果 (x の 正 の 平方 根 ) を 返し ます 。 
* が 負 の 値 で あっ た 場合 に は 0 を 返し , eryzo に 次 の 値 を セッ ト し ます 。 

EDOM 定義 域 エ ラー 

可 搬性 sqrt は UNIX シス テム て で 使用 で き , ANSI C と 互換 性 が あり ます 。 

関連 項目 exp, log, pow 
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機能 乱数 発生 ルー チン を 初期 化し ます 。 

形式 Void srand(unsigned see の ) ・ 

プロ ト タ イ プ stdlib.h 

解説 乱数 発生 ルー チン は , 引数 を 1 と し て srand を 呼び 出す こと で 初期 化す る 


こと が で きま す 。 see9 に 適当 な 値 を 指定 し て srand を 呼び 出せ ば , 乱数 発 
生 の 新た な 開始 点 を セッ ト す る こと が で きま す 。 


戻り 値 あり ませ ん 。 
可 搬性 srand は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 
関連 項目 rand, random, randomize 
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Sscanf 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 
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文字 列 を スキ ャ ン し て 書式 つき 入力 を 行ない ます 。 


int sscanf(const char * が 77er, const char * /orzg7 27ess.…]) ・ 


stdio.h 


sscanf は , 一 連 の 入力 フィ ー ル ド を スキ ャ ン し て , 一 度 に 1 文字 ずつ 文字 列 
か ら 文 字 を 読み 込み ます 。 次 に , 引数 zzg7 に よっ て 指 さ れ る 書式 文字 列 
中 の 書式 指定 に し た が っ て , 各 フ ィ ー ル ド を 書式 化し ます 。 最後 に , /pryzg7 
の 後に 続く 各 引 数 が 示し て いる アド レス に , 書式 化し た 入力 を 格納 し て い 
きま す 。 書式 文字 列 中 の 書式 指定 の 個数 は 、 その 後に 続く アド レス の 数 と 
同じ で な けれ ば な り ま せん 。 

書式 指定 を 含む 詳細 な 情報 に つい て は scanf の 解説 を 参照 し て くだ さい 。 
sscanf は 、 い くつ か の 理由 か ら , 通常 の フィ ー ル ド 終 了 文 字 (ホワ イト ス 
ペー ス ) に 達する 前 に , 特定 の フィ ー ル ド の スキ ャ ン を や め た り , ある い 
は 読み 込み 全体 を や め て し まう こと が あり ます 。 こ うし た 問題 に つい て は , 
scanf の 解説 を 参照 し て くだ さい 。 


sscanf は , 正 し く ス キャ ン し , 変換 し , 格納 し た 入力 フィ ー ル ド の 数 を 返 
し ます 。 戻 り 値 に は , 値 を 格納 し な か っ た 入力 フィ ー ル ド の 数 は 含ま れ ま 
せん 。 

文字 列 の 終わ り を 読み 込ん だ 場合 は 、 戻 り 値 は EOF に な り ま す 。 

値 を 格納 し た フィ ー ル ド が な か っ た 場合 は , 戻り 値 は 0 と な り ま す 。 


sscanf は UNIX シス テム て 使用 で き ,、 ANSIC と 互換 性 が あり ます 。 K& 
R で も 定義 きれ て いま す 。 


fscanf, scanf 
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stat 


形式 


プロ ト タ イ プ 


オー プン ファ イル に 関す る 情報 を 得 ます 。 


#include <sys 壮 stat.h> 
int stat(char * pg struct stat *※ 7 の 7 ) : 


sys ぎ stat.h 


stat は , pg77 に 指定 され た オー プン ファ イル また は ディ レク トリ に 関す る 
情報 を stat 構造 体 の 中 に 格納 し ます 。 ど ちら の 関数 に お いて も , 

sg の 7 は , stat 構造 体 (sys\\stat.h の 中 で 定義 され て いる ) を 指し て いま 
す 。stat 構造 体 に は 次 の よう な フィ ー ル ド が 含ま れ て いま す 。 


sr 7 の ge ファ イル の モー ド に 関す る 情報 を 与え を る ビッ トマ スク 
sf gey その ファ イル が 置か れ て いる ディ スク の ドラ イブ 番号 
S7 7dey s7 gey と 同じ 

半 27773 整定 数 1 に セッ ト 

S7 se オー プン ファ イル の 大 き さ (バイ ト 数 ) 

S7_g が 77e オー プン ファ イル の 一 番 最 近 修正 され た 日 時 

Sr 7 が ie S_ ge と 同じ 

Sc7 が 7e s ge と 同じ 


stat 構造 体 に は 、 これ 以外 に フィ ー ル ド が 3 つ あ り ま す が , DOS で は 意味 
を 持た な い の で 省略 し ます 。 ビ ピット マ スク は オー プン ファ イル の モー ド に 
関す る 情報 を 含ん で お り , 各 ビ ッ ト は 次 の よう な 意味 を 持っ て いま 
す 。 

次 の ビッ ト の うち , いずれ か 1 つが セッ ト さ れ ま す 。 


S_ IFREG pg が が 通常 ファ イル を 指定 し て いる 場合 
S_IFDIR pg が ディ レク トリ を 指定 し て いる 場合 
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戻り 値 


関連 項目 
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次 の 一 方 また は 両方 の ビッ ト が セッ ト さ れ ま す 。 


S_IWRITE ユーザ が 書き 出し 許可 を 得 て い る 場合 
S_IREAD ユー ザ が 読み 込み 許可 を 得 て い る 場合 


ビッ トマ スク に は ユー ザ 実 行 ビッ ト も 含ま れ て いま す 。 こ れ は 、 オー プン 
ファ イル の 拡張 子 に し た が っ て セッ ト さ れ ま す 。 ビ ッ ト マ スク に は , さら 
に 読み 込み / 書 き 出し ビッ ト も 含ま れ て いま す 。 こ れ ら は ファ イル の 許可 モ 
ー ド に し た が っ て セッ ト さ れ ま す 。 


stat は 。 その オー プン ファ イル に 関す る 情報 を うま く 得 られ た 場合 は 0 を 
返し ます 。 エ ラー の 場合 は -1 を 返し , errzo に 次 の 値 を セッ ト し ます 。 


ENOENT バス 名 また は ファ イル 名 が 見 つか ら な い 


acces8, chmod, fstat, stat 
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ーー ニニ ーー デー ニー ーー ニー ニー ニー テー ニュー ニュ 
_Sstatus87 


機能 党 動 小数 点 ス テー タス を 得 ま す 。 

形式 unsigned int status87 (void) : 

プロ ト タ イ プ floath 

解脱 _-Status87 は 。 浮動 小数 点 ス テー タス ワー ド を 取り 出し ます 。 浮動 小数 点 ス 
テー タス ワー ド は , 8087/80287 の ステ ー タ スワ ー ド と 8087/80287 例 外 ハン 


ドラ に よっ て 検出 され る 他 の 条件 を 組み 合わ せ た も の で す 。 


戻り 値 戻り 値 の 各 ビン ト が 浮動 小数 点 ス テー タス を 示し ます 。 status87 が 返す 
ビッ ト の 意味 に つい て は float.h を 参照 し て くだ さい 。 


関連 項目 _clear87, control87, fpreset 


例 _control87 を 参照 し て くだ さい 。 
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機能 時 刻 を セッ ト す る 


形式 #include <time.h> 


int stime(time t *※ の ) : 


プロ ト タ イ プ time.h 


解説 stime は 、 シス テム の 時 刻 と 日 付 を セッ ト し ます 。 の は, GMT1970 年 1 月 
1 日 の 00 : 00 : 00 か ら , 設 定 する 日 付 時 刻ま で の 経過 秒 数 を 表わす 値 を 指し 
ます 。 

戻り 値 stime は 、 成功 し た 場合 は 0 を 返し ます 。 

可 搬性 stime は UNIX シス テム で 使用 で きま す 。 

関連 項目 asctime, ftime, gettime, gmtime, localtime, time, tzset 
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StDcDy 


機能 ある 文字 列 を 他 の 文字 列 に コピ ー し ます 。 

形式 char * stpcpy(char * 9es7, const char * sc) : 

プロ ト タ イ プ string.h 

解説 stpcpy は 、syc か ら gdes7 へ ヘコ ピー を 行ない ます 。 ヌ ル 終 了 文 字 に 出会っ た 
と ころ で コピ ー を や め ま す 。 

戻り 値 stpcpy は , ges7 十 strlen(syc) を 返し ます 。 

可 搬性 stpcpy は UNIX シス テム て 使用 で きま す 。 

Strcat 

機能 ある 文字 列 を 他 の 文字 列 に 付け 加え ます 。 

形式 char * strcat(char * des, const char * yc) : 

プロ ト タ イ プ string.h 

解説 strcat は , sc の コビー を gesr の 最後 に 付け 加え ます 。 得 られ る 文字 列 の 長 
さ は , strlen (ges7) 十 strlen(yc) に な り ま す 。 

戻り 値 strcat は 連結 され た 文字 列 へ の ポイ ンタ を 返し ます 。 

可 搬性 strcat は UNIX シス テム て 使用 で き 、 ANSIC と 互換 性 が あり ます 。K& 


R で も 定義 きれ て いま す 。 
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strchr 


機能 文字 列 を 調べ て , 指定 の 文字 が 最初 に 現われ る 位置 を 探し ます 。 

形式 char * strchr(const char * sint c) : 

プロ ト タ イ プ string.h 

解説 strchr は 、 文字 列 を 先頭 か ら 調べ て , 指定 の 文字 を 探し ます 。strchr は , 
文字 列 s の 中 で 最初 に 現われ る 文字 c を 見 つけ ます 。 
ヌル 文字 も 文字 列 の 一 部 と 考え る の で , た と えば 次 の 呼び 出し は , 
strchr(strs。 0) 
文字 列 の 最後 の メル 文字 を 指す ポイ ンタ を 返し ます 。 


戻り 値 strchr は , ゞ の 中 で 最初 に 見 つか っ た 文字 c へ の ポイ ンタ を 返し ます 。 


可 搬性 strcat は UNIX シス テム て 使用 で き , ANSIC と 互換 性 が あり ます 。K& 
R で も 定義 され て いま す 。 
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strcmp 


機能 ある 文字 列 と 他 の 文字 列 を 比較 し ます 。 
形式 int strcmp(const char * s/, const char * 52) : 
プロ ト タ イ プ string.h 
解説 strcmp は 、s/ と 52 中 の 各 文字 を unsigned char と し て 比較 し ます 。 比 較 
は 各 文 字 列 の 最初 の 文字 か ら 始 め , 異な る 文字 が 見 つか る まで , ある い は 
文字 列 の 終わ り に 達する まで 続け ます 。 
戻り 値 stremp は 次 の よう な 値 を 返し ます 。 
<0 s7 が s2 より 小さ い 
ニテ 0 5s7 と 32 が 等 し い 


>0 37 が s2 より 大 きい 


可 搬性 strcmp は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


405 


strcmpi 


機能 文字 ケー ス を 区 別 せ ず に , 2 つの 文字 列 を 比較 し ます 。 


形式 #include <string.h> 


nt strcmpi(const char * s/,const char * 52) : 


プロ ト タ イ プ string.h 


解説 strempi は , 文字 ケー ス (大 文字 / 小 文字 ) を 区 別 せ ず に , ?7 と 52 中 の 各 
文字 を unsigned char と し て 比較 し ます 。 比 較 は 各 文字 列 の 最初 の 文字 か 
ら 始め 異な る 文字 が 見 つか る まで , ある い は 文字 列 の 終わ り に 達する ま 
で 続け ます (stricmp と 同じ で す が , strcmpi は マク ロ で す )。 
strcmpi は , 5/ (また は その 一 部 ) を s2 (また は その 一 部 ) と 比較 し た 結 
果 に 基づい て 負 , ゼロ , 正 の 値 を 返し ます 。 
strcmpi は stricmp と 同じ で す 。strempi は 、 string.h の 中 で stricmp の 呼 
び 出 し に 変換 され る マク ロ と し て 定義 きれ て いま す 。 し た が っ て , strcmmpi 
を 使う と き に は ヘッ ダフ ァイル string.h を イン クル ー ド し な けれ ば な り ま 
せん 。 こ の マク ロ は 他 の C コン パイ ラ と の 互換 性 の た め に 用 意 き れ て いま 


す 。 
戻り 値 strcmpi は 次 の よう な 値 を 返し ます 。 
<0 s7 が s2 より 小さ い 
= テテ 0 5s7 と 52 が 等 し い 
>0 7 が s2 より 大 きい 


これ ら 6 つ の 関数 は 符号 を 考慮 し た 比較 を 行ない ます 。 
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StrcDy 


機能 ある 文字 列 を 他 の 文字 列 に コピ ー し ます 。 


形式 char * strcpy(char * des/, const char * ye) : 


プロ ト タ イ プ string.h 


解説 strcpy は , 文字 列 sc を des7 に コピ ー し ます 。 最後 の メル 文字 を コピ ー し 
た と ころ で コピ ー が 終わ り ま す 。 


戻り 値 strcpy は 、 des7 を 返し ます 。 


可 搬性 strcpy は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 
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StrcsDn 


機能 


プロ ト タ イ プ 


戻り 値 


可 搬 性 
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文字 列 を スキ ャ ン し , 指定 の 文字 集合 に 含ま れ な い 文 字 の みか ら な る 最初 
の 部 分 を 探し ます 。 


#include <string.h> 
size t strcspn(const char * 7,const char * 52) : 


string.h 


strcspn は , 文字 列 s/ を 調べ て , 文字 列 s2 に 含ま れ て いな い 文 字 の みか ら 
な る 最初 の 部 分 を 見 つけ ます 。 


strcspn は , 5/7 中 の , 52 に 含ま れ て いな い 文字 の みか ら な る 最初 の 部 分 の 
長き を 返し ます 。 


strcspn は UNIX シス テム て で 使用 てき, ANSI C と 互換 性 が あり ます 。 
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strdup 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


文字 列 を 新た に 作成 し た 記憶 場所 に コピ ー し ます 。 


char * strdup(const char *※ ゞ ) : 


string.h 


strdup は 、 文字 列 s の 複製 を 作り ます 。 複製 を 格納 する 領域 malloc を 
呼び 出し て 確保 し ます 。 領 域 の 大 き さ は (strlen(s) 十 1) バ イト で す 。 


strdup は 、 複製 され た 文字 列 が 格納 され て いる 記憶 場所 を 指す ポイ ンタ を 
返し ます 。 記 境 場所 が 確保 で き な か っ た 場合 は NULL を 返し ます 。 


strdup は UNIX シス テム で 使用 で きま す 。 


free 
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_StrerrOr 


機能 


形式 


プロ ト タ イ プ 


解脱 


戻り 値 


関連 項目 
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エラ ー メ ッ セ ー ジ 文字 列 を 指す ポイ ンタ を 返し ます 。 
char * strerror(const char *※ $) ・ 
string.h, stdio.h 


_strerror は 、 ユー ザ 専 用 の エラ ー メ ッ セ ー ジ を 生成 する た め の 関数 で す 。 
これ は , ヌル で 終わ る エラ ー メ ッ セ ー ジ 文字 列 を 指す ポイ ンタ を 返し ます 。 


5 が NULL の 場合 、 戻 り 値 に は 一 番 新 し い シ ステ ム エ ラ ー メ ッ セ ー 
ジ が 含ま れ て いま す 。 こ の 文字 列 は ヌル 文字 で 終わ っ て いま す 。 

還 が NULL で な い 場 合 は , 戻り 値 に は ゞ (ユー ザ 定 義 の メッ セー 
ジ ), コロ ン , 空白 、 一 番 新 し い シ ステ ム エ ラ ー メ ッ セ ー ジ , 改行 文字 
が 含ま れ て いま す 。 ゞ の 長き は 94 文 字 以 下 で な けれ ば な り ませ ん 。 


Turbo C の バー ジョ ン 1.0 で は , _strerror は strerror と 同じ も の で し た 。 
_strerror は , エ ラー メッ セー ジ 文 字 列 を 指す ポイ ンタ を 返し ます 。 この 文 
字 列 は 静 的 な バッ ファ に 格納 され る の で , _strerror を 呼び 出す た びに 上 


書き され ます 。 


perror, StrerrOr 
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Strerror 


機能 エラ ー メ ッ セ ー ジ 文字 列 を 指す ポイ ンタ を 返し ます 。 


形式 char * strerror(int ez) ・ 


プロ ト タ イ プ stdio.h, string.h 


解説 strerror は , エ ラー 番号 ez を 引数 に と り , これ に 対応 する エラ ー メ ッ 
セー ジ 文 字 列 を 指す ポイ ンタ を 返し ます 。 


戻り 値 strerror は 、 エ ラー メッ セー ジ 文 字 列 を 指す ポイ ンタ を 返し ます 。 こ の 文 
字 列 は 静 的 な バッ ファ に 格納 され る の で , strerror を 呼び 出す た びに 上 書 
きき され ます 。 

可 搬性 strerror は ANSI C と 互換 性 が あり ます 。 

関連 項目 perror, Strerror 
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Stricmp 


機能 


形式 


プロ ト タ イ プ 


戻り 値 
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大 文字 小文字 を 区 別 せ ず に , 2 つの 文字 列 を 比較 し ます 。 


int stricmp(const char * s/,const char * 52) : 


string.h 


stricmp は , 文字 ケー ス (大 文字 / 小 文字 ) を 区 別 せ ず に , 57 と 52 中 の 各 
文字 を unsigned char と し て 比較 し ます 。 比 較 は 各 文 字 列 の 最初 の 文字 か 
ら 始 め , 異な る 文字 が 見 つか る まで , ある い は 文字 列 の 終わ り に 達する ま 
で 続け ます 。 

stricmp は 、s/ (また は その 一 部 ) を s2 (また は その 一 部 ) と 比較 し た 結 
果 に 基づい て 負 、 ゼロ , 正 の 値 を 返し ます 。 

stricmp は strcmpi と 同じ で す が , strcmpi は , string.h の 中 で stricmp の 
呼び 出し に 変換 され る マク ロ と し て 定義 る され て いま す 。 


stricmp は 次 の よう な 値 を 返し ます 。 


<⑩0 7 が s2 より 小さ い 
ニテ 0 537 と 52 が 等 し い 
20 57 が s2 より 大 きい 
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strlen 


機能 文字 列 の 長 さ を 計算 し ます 。 

形式 #include <string.h> 
size t strlen(const char * 5) : 

プロ ト タ イ プ string.h 

解脱 strlen は 、 文 字 列 ゞ の 長 さ を 計算 し ます 。 

戻り 値 strlen は 、s 中 の 文字 の 個数 を 返し ます 。 ヌ ル 文 字 は カウ ント し ませ ん 。 

可 搬性 strlen は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 

strlwr 

機能 文字 列 の 中 の 大 文字 を 小文字 に 変換 し ます 。 

形式 char * strlwr(char *※ 5) ・ 

プロ ト タ イ プ string.h 

解説 strlwr は , 文字 列 s の 中 の 大 文字 (AZ) を 小文字 (Aa 一 2) に 変換 し ま 
す 。 英 字 以 外 の 文字 は 変更 きれ ませ ん 。 

戻り 値 strlwr は , 文字 列 sy へ の ポイ ンタ を 返し ます 。 

関連 項目 strupr 
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strncat 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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ある 文字 列 の 一 部 分 を 他 の 文字 列 に 付け 加え ます 。 


#include <string.h> 


char * strncat(char *※ des/。 const char * src, size t 7zx/gz) ・ 
string.h 

strncat は 、 sc の 最大 7xgxez 個 の 文字 を , gesr の 終わ り に 付け 加え , 最 
後に ヌル 文字 を 付加 し ます 。 得 られ る 文字 列 の 長き の 上 限 は , strlen 
(des/) 填 7gxfeg に な り ます 。 


strncat は 、 ges7 を 返し ます 。 


strncat は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 
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strncmp 


機能 ある 文字 列 の 一 部 分 と 他 の 文字 列 と 比較 し ます 。 


形式 #include <string.h> 
int strncmp(const char * s/, const char *※ s2, size t ix/e) : 


プロ ト タ イ プ string.h 


解説 strncmp は , strcmp と 同様 に , 文字 列 y/ と s2 中 の 各 文 字 を unsigned 
char と し て 比較 し ます 。 比較 は 各 文 字 列 の 最初 の 文字 か ら 始め , 異な る 文 
字 が 見 つか る まで , また は 7gxez 個 の 文字 を 比較 する まで , ある い は 文字 
列 の 終わ り に 達する まで 続け ます 。 
strncmp は , s7 (また は その 一 部 ) を s2 (また は その 一 部 ) と 比較 し た 結 
果 に 基づい て 負 , ゼロ , 正 の 値 を 返し ます 。 


戻り 値 strncmp は 次 の よう な 値 を 返し ます 。 
KU s7 が s2 より 小さ い 
ニテ 0 57 と 5s2 が 等 し い 


>0 57 が s2 より 大 きい 


可 搬性 strncmp は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


415 


Strncmmpi 


機能 ある 文字 列 の 一 部 分 と 他 の 文字 列 の 一 部 分 を , 大 文字 小文字 を 区 別 せ ず に 
比較 し ます 。 
形式 #include <string.h> 


int strncmpi(const char * s7.const char * 52,sizet カ ) : 


プロ ト タ イ プ string.h 


解説 strncmpi は , 文字 ケー ス (大 文字 / 小 文字 ) を 区 別 せ ず に , s7 と 52 中 の 最 
大 ヵ バ イト の 文字 を unsigned char と し て 比較 し ます 。 比較 は 各 文字 列 の 
最初 の 文字 か ら 始め , 異な る 文字 が 見 つか る まで , また は ヵ 個 の 文字 を 比 
較 す る まで , ある い は 文字 列 の 終わ り に 達する まで 続け ます (strncmpi は 
strnicmp と 同じ で す が 、 strncmpi は マク ロ で す )。 
strncmpi は , s/ (また は その 一 部 ) を s2 (また は その 一 部 ) と 比較 し た 結 
果 に 基づい て 負 、 ゼロ , 正 の 値 を 返し ます 。 
strncmpi は strnicmp と 同じ で す が , strncmpi は , string.h の 中 で strnic- 
mp の 呼び 出し に 変換 され る マク ロ と し て 定義 きれ て いま す 。 し た が っ て , 
strncmpi を 使う と き に は ,、 ヘ ッ ダ ファ イル string.h を イン クル ー ド し な け 
れ ば な り ま せん 。 


戻り 値 strncmpi は 次 の よう な 値 を 返し ます 。 
<⑩ 7 が s2 より 小さ いり 場 合 


ニテ 0 537 と 52 が 等 し 場合 
>0 37 が s2 より 大 きい 場合 
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strncDy 


機能 ある 文字 列 の 一 部 を 他 の 文字 列 に コピ ビー し ます 。 必要 な 場合 に は 削除 ある 
い は バディ ン グ を 行ない ます 。 


形式 #include <stdio.h> 
char * Strncpy(char * des/, const char 玉 se, Size t 7 の X/eZ) ・ 


プロ ト タ イ プ string.h 

解説 strncpy は , 最大 x/ez 個 の 文字 を wc か ら desy7 に コピ ー し ます 。 長 すぎ 
れ ば 削り , 短 か す ぎれ ば ヌル 文字 を es に 埋め こみ ます 。 es7 に は 、 yc の 
長 さ が gxez 以上 の 場合 は 、 最後 に ヌル 文字 は つけ られ ませ ん 。 


戻り 値 strncpy は 、 ges7 を 返し ます 。 


可 搬性 strncpy は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 
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strnicmp 


機能 ある 文字 列 の 一 部 分 と 他 の 文字 列 の 一 部 分 を , 大 文字 小文字 を 区 別 せ ず に 
比較 し ます 。 
形式 #include <string.h> 


int strnicmp(const char *※ s/,const char *※ 52, Size t 49X/e) ・ 


プロ ト タ イ プ string.h 


解説 strnicmp は , 文字 ケー ス (大 文字 / 小 文字 ) を 区 別 せ ず に , s7 と 52 中 の 最 
大 n バイ ト の 文字 を unsigned char と し て 比較 し ます 。 比 較 は 各 文 字 列 の 
最初 の 文字 か ら 始 め , 異な る 文字 が 見 つか る まで , また は ヵ 個 の 文字 を 比 
較 す る まで , ある い は 文字 列 の 終わ り に 達する まで 続け ます (strnicmp は 
strncmpi と 同じ で す が , strncmpi は マク ロ で す )。 
strnicmp は , 5/ (また は その 一 部 ) を 52 (また は その 一 部 ) と 比較 し た 結 
果 に 基づい て 負 , ゼロ 、 正 の 値 を 返し ます 。 
strncmpi は strnicmp と 同じ で す が , strncmpi は , string.h の 中 で strnic- 
mp の 呼び 出し に 変換 され る マク ロ と し て 定義 され て いま す 。 


戻り 値 strmicmp は 次 の よう な 値 を 返し ます 。 
<⑩0 s7 が s2 より 小さ いり 場合 


=0 57 と 52 が 等 し い 場 合 
20 37 が s2 より 大 きい 場合 
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Strnset 


失 能 文字 列 中 の 指定 個数 の 文字 に 指定 の 文字 を セッ ト し ます 。 


形式 #include <string.h> 
char * strnset(char * $,int c7, size t カ ) 


プロ ト タ イ プ string.h 

解説 strnset は 文字 列 s の 先頭 か ら ヵ バイ ト に 文字 c4 を コピ ー し ます 。 
strlen (s) の 場合 、 ヵ は strlen(5) に 半 き 換え られ ます 。 
コピ ー は , ヵ 文字 を セッ ト す る まで , ある い は ヌル 文字 が 見 つか る ま て で 行 な 
われ ます 。 


戻り 値 strnset は ゞ を 返し ます 。 
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strpbrk 


機能 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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文字 列 を 調べ て 、 指定 し た 文字 集合 中 の 文字 が 最初 に 現われ る 場所 を 探し 
ます 。 


char * strpbrk(const char * s/7, const char * 52) : 


string.h 


strpbrk は , 文字 列 s7 を 調べ て , 文字 列 s2 に 含ま れる どれ か 1 文字 が 最初 
に 現われ る 位置 を 探し ます 。 


strpbrk は , 52 内 の 文字 の どれ か が 最初 に 現われ る 場所 を 指す ポイ ンタ を 
返し ます 。 見 つか ら な いり 場合 は NULL を 返し ます 。 


strpbrk は UNIX シス テム て で 使用 で き , ANSI C と 互換 性 が あり ます 。 
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機能 文字 列 を 調べ て , 指定 し た 文字 が 最後 に 現われ る 場所 を 探し ます 。 

形式 char * strrchr(const char * sint c) : 

プロ ト タ イ プ string.h 

解説 strrchr は , 文字 列 を 終わ りか ら 逆 方 向 に 調べ て , 指定 の 文字 を 探し ます 。 
strrchr は , 文字 列 s の 中 で 最後 に 現われ る 文字 c を 見 つけ ます 。 ヌ ル 文 字 
も 文字 列 の 一 部 と 考え ます 。 

戻り 値 strrchr は , 文字 c が 最後 に 現われ る 場所 を 指す ポイ ンタ を 返し ます 。 見 つ 
か ら な い 場 合 は NULL を 返し ます 。 

可 搬 性 strrchr は UNIX シス テム て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 

StrreY 

機能 文字 列 を 逆転 させ ます 。 

形式 char * strrev(char *※ 5) : 

プロ ト タ イ プ string.h 

解説 strrev は , 文字 列 s の 中 の すべ て の 文字 を , 最後 の メル 文字 は 除い て 逆順 
に 並べ 換え ます (た と えば , string\0 は gnirts ま 0 に な り ま す )。 

戻り 値 strrev は , 逆順 に な っ た 文字 列 を 指す ポイ ンタ を 返し ます 。 エ ラー の 戻り 


値 は あり ませ ん 。 
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strset 


機能 文字 列 中 の すべ て の 文字 を 指定 の 文字 に 変更 し ます 。 


形式 char * strset(char * s,int c が ) : 


プロ ト タ イ プ string.h 


解説 strset は 。 文字 列 sy の 中 の すべ て の 文字 に 文字 c4 を セッ ト し ます 。 ヌル 文 
字 に 出会っ た と ころ で 終了 し ます 。 


戻り 値 strset は 、 ゞ を 返し ます 。 


関連 項目 setmem 
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機能 文字 列 を 調べ て , 指定 の 文字 集合 に 含ま れる 文字 の みか ら な る 最初 の 部 分 
を 探し ます 。 
形式 #include <string.h> 


size_t strspn(const char * 57, conSt char ※ 52) ・ 


プロ ト タ イ プ string.h 


解説 strspn は 。 文字 列 s/ を 調べ て , 文字 列 52 に 含ま れる 文字 の みか ら な る 最 
初 の 部 分 を 探し ます 。 

戻り 値 strspn は 。 7 中 の , 52 に 含ま れる 文字 の みか ら な る 最初 の 部 分 の 長き を 返 
し ます 。 

可 搬 性 strspn は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 
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Strstr 


機能 文字 列 を 調べ て , 指定 の 部 分 文字 列 が 現われ る 場所 を 探し ます 。 
形式 char * strstr(const char *※ 57,const char * 52) : 


プロ ト タ イ プ string.h 


解説 strstr は 。 文字 列 s/ を 調べ て , 部 分 文字 列 s2 が 最初 に 現われ る 位置 を 探し 
ます 。 
戻り 値 strstr は 、 52 を 含む s/ 中 の 要素 を 指す (s/ 中 の s2 を 指す ) ポイ ンタ を 返 


し ます 。5s2 が s7 中 に 存在 し な い 場 合 は NULL を 返し ます 。 


可 搬性 strstr は UNIX シス テム で 使用 で き 、 ANSI C と 互換 性 が あり ます 。 
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strtod 
機能 文字 列 を double の 値 へ 変換 し ます 。 
形式 #include <stdlib.h> 
double strtod(const char * 5.char * ネ * egp) : 
プロ ト タ イ プ stdlib.h 
解説 strtod は 、 文字 列 を double の 値 に 変換 し ます 。 ゞ が double の 値 と し て 


解釈 され る た め に は , 次 の よ うち な 形式 に な っ て いな けれ ば な り ませ ん 。 


【ws][sn][ddd][.] [ddd] [fmt[sn]ddd] 


各部 分 は 三 の よ うに な り ま す 。 


[is] ホワ イト スペ ー ス (な く て も よい ) 
[sz] 符号 (また は -, な く て も よい ) 
[22g] 数 字 の 並び (を なく て も よい ) 
[7zz] e か EE (な く て も よい ) 

[.] 小数 点 (な く て も よい ) 


strtod は さら に , 十 INF お よび -INF を 、 プ ラス 無限 大 お よび マイ ナス 無 
限 大 と し て 認識 し ます 。 ま た , 十 NAN お よび -NAN を 非 数 (Not a Num- 
ber) と し て 解釈 し ます 。 

strtod で double に 変換 で きる 文字 列 は 次 の よう な も の で す 。 

+1231 .1981 e-1 

502.85E2 

-2010.952 

strtod は double の 数 値 と し て 解釈 で き な い 文字 が ある と 読み 込み を や め 
ます 。 ez の が NULL で な けれ ば , ez の を , 読み 込み を や め た 文字 を 指 
す よ うに セッ ト し ます (* ez の ー s/oppey) 。 
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戻り 値 strtod は ,s を 変換 し た 値 を double と し て 返し ます 。 オー バー フロ ー が 起 
きた 場合 は HUGE_ VAL を 返し ます 。 


可 搬性 strtod は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


関連 項目 atof 
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strtok 


形式 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬性 


文字 列 か ら ト ー ク ン を 次 々 に 切り 出し ます 。 ト ー ク ン は 2 番目 に 指定 し た 文 
字 列 の 中 に 入っ て いる 文字 に よっ て 区 切ら れ ま す 。 


char * strtok(char * 57,const char * 52) : 


string.h 


strtok は 、 文字 列 s7 は , s2 に 含ま れ て いる 文字 (区 切り 子 ) に よっ て 区 切 
られ る トー クン を いく つか 含ん で いる も の と 考え ます 。 

strtok を 最初 に 呼び 出す と ,s/ 中 の 最初 の トー クン の 先頭 文字 を 指す ポイ 
ンタ を 返し 、 返 され た トー クン の 直後 に ヌル 文字 を 書き ます 。 そ の 後 、 最 
初 の 引数 と し て NULL を 指定 し て strtok を 連続 し て 呼び 出す と , strtok 
は , 57 に トー クン が な く な る まで 次 の トー クン を 探し て いき ます 。 

区 切り 子 文字 列 s2 は , 呼び 出し ご と に 変化 し て も か まい ませ ん 。 

strtok は , s7 中 の 見 つか っ た トー クン へ の ポイ ンタ を 返し ます 。 それ 以上 
トー クン が な い 場 合 に は NULL を 返し ます 。 


strtok は UNIX シス テム で 使用 で き , ANSI C と 互換 性 が あり ます 。 


42Z 


428 


/* strtok - この 例題 は , strtok を 使っ て 日 付 を 表す 文字 列 を 
分 割 し ます 。 形 式 の 異な る 日 付 (12/3/87 , Dec.12,1987 : 
January 15,。 1987 : 12-FEB-87。 etc.) を 扱う 場合 , 区 切り 
文字 の 文字 列 に は , 必要 な 文字 (ビリ オド , 空白 。 カン マ 。 


マイ ナス な ど ) を 入れ る 必要 が あり ます 。 
出力 に は 区 切り 文字 は 含ま れ ま せん 。 

/ 

すま include <stdio.h> 

1nclude <string.h> 


main () 
{ 
char *ptri 


ptr = strtok ("PEB.14,1988"。*。 。-/" 


while (ptr !=NULL) 
も 
printf ("ptr = Zen"。 ptr)s 
ptr = strtok (NULL。*。 。-/" ) う 5 
) 


プロ グラ ム 出 力 


Ptr = FEB 
ptr = 14 
ptr = 1988 


): 
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strtol 


機能 


形式 


プロ ト タ イ プ 


解脱 


文字 列 を long の 値 に 変換 し ます 。 
long strtol(const char * ,char ** ez の か が, int 7 の ) 


stdlib.h 


strtol は 、 文字 列 ゞ を long の 値 に 変換 し ます 。 ゞ が long の 値 と し て 解釈 さ 
れる た め に は , 次 の よう な 形式 に な っ て いな けれ ば な り ま せん 。 


【ws][sn][0][x][ddd] 


各部 分 は 大 の よう に な り ま す 。 


[ws] ホワ イト スペ ー ス (な く て も よい ) 
[sz] 待 号 (すま た は -,。 な く て も よい ) 
[0] ゼロ (な く て も よい ) 

[x] x また は X (な く て も よい ) 


[2gg] 数 字 (な く て も よい ) 


strtol は 、 認識 で き な い 文字 の と ころ て 文字 列 を 読む の を や め ま す 。 
gd が 2 一 36 の 場合 は 、long 型 整数 は 7ggix を 基底 と し て 表現 され ます 。 
7 が 0 の 場合 は , s の 先頭 の 何 文字 か に よっ て 何 進 法 で ある か が 決ま り 
ます 。 


最初 の 文字 2 番目 の 文字 文字 列 


0 1 に > 8 進 表 記 
0 x また は XX 16 進 表記 
1-9 10 進 表記 
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戻り 値 


可 搬性 


関連 項目 
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7gdix が 1 の 場合 は 、 無効 な 値 と みな され ます 。7ggdx が 負 あ る い は 36 を 越え 
る 場合 は , エラ ー と な り ま す 。 

7gdix と し て 正しく な い 値 を 指定 する と , 結果 は 0 と な り , 次 の 文字 ポイ ン 
タ を 開始 文字 列 ポ イン タ に セッ ト し ます 。 

5 が 8 進数 と し て 解釈 され る 場合 は 0 一 7 以外 の 文字 は 認識 され ませ ん 。 

ゞ が 10 進 数 と し て 解釈 され る 場合 は 、 0 一 9 以外 の 文字 は 認識 され ませ ん 。 

5 の 値 が 他 の 数 を 基底 と する 数 と し て 解釈 され る 場合 は , 数 字 と , その 基底 
で 使用 きれ る 英字 だ けが 認識 され ます 。 たとえば, 基底 が 20 の と き は , 0-9 
お よび Aー 二 が 認識 され ます 。 


strtol は , 文字 列 を 変換 し た 値 を 返し ます 。 エ ラー の 場合 は 0 を 返し ます 。 


strtol は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


atoi, atol, strtoul 
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strtoul 


機能 文字 列 を unsigned long の 値 に 変換 し ます 。 


形式 unsigned long strtoul(const char * s,char * 玉 ez の p7, int 7 の ) : 


プロ ト タ イ プ stdiibjh 


解説 strtoul は , 文字 列 s を unsigned long 型 の 値 へ 変換 する 以外 は , strtol と 
同じ で す 。 詳 細 に つい て は strtol を 参照 し て くだ さい 。 


戻り 値 strtoul は , 変換 し た 値 を unsigned long で 返し ます 。 エ ラー の 場合 は 0 を 
返し ます 。 
可 搬性 strtoul は ANSI C と 互換 性 が あり ます 。 


関連 項目 atol, strtol 
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機能 文字 列 中 の 小文字 を 大 文字 に 変換 し ます 。 
形式 char * strupr(char *※ ) : 
プロ ト タ イ プ string.h 


解説 strupr は , 文字 列 s の 中 の 小文字 (aーz) を 大 文字 (AーZ) に 変換 し ま 
す 。 英 字 以 外 の 文字 は 変更 きれ ませ ん 。 


戻り 値 strupr は 、 ゞ を 返し ます 。 


関連 項目 strlwr 
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機能 バイ ト を 入れ 替え ます 。 

形式 void swab(char * /oz, Char * /O, int 7 の yes) : 

プロ ト タ イ プ stdlib.h 

解説 swab は , 文字 列 7roz: か ら 文字 列 7o へ の yes バイ ト を コピ ー し ます 。 こ 
の と き 、 隣り 合う 偶数 位置 と 奇数 位置 の バイ ト が 入れ 替え られ ます 。 こ れ 
は バイ ト の 並べ 方 が 異な る マシ ン か ら の デー タ を 処理 する 場合 に 便利 で す 。 
yes は 偶数 で な けれ ば な り ま せん 。 


戻り 値 あり ませ ん 。 


可 搬性 swab は UNIX シス テム で 使用 で きま す 。 
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System 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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DOS コマ ンド を 実行 し ます 。 


int system (const char * cozz7zgz の ) : 


stdlib.h, process.h 


system は ,C プ ログ ラム の 中 か ら , DOS の COMMAND.COM を 呼び 出し 
て , 文字 列 cozzzgz の 9 で 与え られ た DOS コマ ンド , バッ チ フ ァイル ある い 
は 他 の プロ グラ ム を 実行 し ます 。 

実行 され る プロ グラ ム は , カレ ント ディ レク トリ か 環境 変数 PATH に セ 
ッ ト さ れ て いる ディ レク トリ に 置か れ て いな けれ ば な り ま せん 。 
COMMAND.COM ファ イル を 探す た め に , 環境 変数 COMSPEC が 使わ れ 
ます 。 したがって, COMMAND.COM は カレ ント ディ レク トリ に 存在 する 
必要 は あり ませ ん 。 


system は , 成功 し た 場合 は 0、 失 敗 し た 場合 に は -1 を 返し ます 。 


system は UNIX シス テム て 使用 で き , ANSIC と 互換 性 が あり ます 。 K& 
R で も 定義 きれ て いま す 。 


exec.…, fpreset, searchpath, spawn.… 


第 2 章 Turbo C ラ イブ ラリ 


tan 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


正 接 を 求め ます 。 


#include <math.h> 
double tan(double x) : 


math.h 
tan は 入力 値 の 正 接 (タン ジェ ント ) を 計算 し ます 。 角度 * は ラジ アン 
単位 で 指定 し ます 。 
tan の エラ ー 処 理 は 、 関数 matherr を 使っ て 変更 する こと が で きま す 。 
tan は , * の 正 接 を 返し ます 。 す べ て の 有効 な 角度 に 対し て 値 を 返し ます 
が ,- ァ /2 や ァ /2 に 近い 角度 の 場合 は 0 を 返し , eryzzo に 交 の 値 を セッ ト し 
ます 。 

ERANGE 値 城 エラ ー 


tan は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


acoSs, aSin, atan, atan2, cos, cosh, sin, sinh, tanh 
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プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 
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双曲線 正 接 を 求め ます 。 


#include <math.h> 
double tanh(double *) : 


mathh 

tanh は , 実数 引数 の 双曲線 正 接 (ハイ パ ポ リッ クタ ンジ ェ ン ト ) を 計算 し 
ます 。 

tanh の エラ ー 処 理 は 、 matherr 関数 を 通し て 変更 する こと が で きま す 。 
tanh は , * の 双曲線 正 接 を 返し ます 。 


tanh は UNIX シス テム て で 使用 で き 、 ANSI C と 互換 性 が あり ます 。 


acoS, asin, atan, atan2, cos, cosh, sim, sinh, tam 
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tell 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


ファ イル ポイ ンタ の 現在 位置 を 得 ます 。 


long tell(int gzg/e) : 


io.h 


tell は , 4gzge に 結び つけ られ て いる ファ イル ポイ ンタ の 現在 位置 を 得 
て , それ を ファ イル の 先頭 か ら の バイ ト 数 と し て 示し ます 。 


tell は , ファ イル ポイ ンタ の 現在 位置 を 返し ます 。 エラ ー の 場合 は -1L を 返 
し , eryzo に 次 の 値 を セッ ト し ます 。 


EBADF ファ イル 番号 が 正しく な い 


tell は すべ て の UNIX シス テム で 使用 で きま す 。 


fgetpos, fseek、 ftell, lseek 
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time 


機能 


形式 


プロ ト タ イ プ ブ 


戻り 値 


可 搬性 


関連 項目 
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時 刻 を 得 ます 。 


#include <time.h> 


time ttime(time t ※ 7 が ze/) 

time.h 

time は , GMT( グ リ ニ ッ ジ 標 準 時 刻 ) 1970 年 1 月 1 日 の 00 : 00 : 00 か ら 現 在 
まで の 経過 時 間 を 秒 単位 で 与え 、 その 値 を が er が 指す 記憶 場所 に 格納 し 
ます 。 er に は , NULL で な い ポ イン タ を 与え る 必要 が あり ます 。 

time は , 上 に 述べ た 時 刻 を 秒 単位 で 返し ます 。 


time は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 


asctime, ctime, difftime, ftime, gettime, gmtime, localtime, 
settime, stime, tzset 
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tmpfile 


機能 "スクラッチ" ファ イル を バイ ナリ モー ド で オー プン し ます 。 


形式 #include <stdio.h> 
FILE * tmpfile(void) : 


プロ ト タ イ プ stdio.h 
解説 tmpfile は 、 テン ポラ リ (一 時 的 ) バイ ナリ ファ イル を 作成 し , 更新 用 (" 
ゅ 十 の ) と し て オー プン し ます 。 この ファ イル は , クロ ー ズ し た り プ ログ ラ 


ム が 終了 し た 時 点 で , 自動 的 に 削除 され ます 。 


戻り 値 tmpfile は , 作成 し た テン ポラ リフ ァイル の スト リー ム を 指す ポイ ンタ を 
返し ます 。 フ ァイル を 作成 で き な か っ た 場合 は NULL を 返し ます 。 


可 搬性 tmpfile は UNIX シス テム で 使用 で き 、ANSI C と 互換 性 が あり ます 。 


439 


tmpnam 


機能 ユニ ー ク な ファ イル 名 を 作り ます 。 
形式 char * tmpnam(char * 5) : 
プロ ト タ イ プ stdio.h 


解説 tmpnam は ユニ ー ク な ファ イル 名 を 作り 出し ます 。 そ の ファ イル 名 は テン 
ポラ リ (一 時 的 ) ファ イル の 名 前 と し て 安全 に 使う こと が で きま す 。 
tmpnam は , 最大 TMP_ MAX 回 まで , 呼び 出す た びに 異な る 文字 列 を 発 
生 し ます 。TMP _ MAX は, stdio.h の 中 で 65535 と 定義 8 れ て いま す 。 
tmpnam の 引数 s は 、 NULL か 、 最 低 / ypzg7i 個 の 文字 を 要素 に 持つ 配 
列 へ の ポイ ンタ で す 。 の の zo が 7 は stdio.h の 中 で 定義 きれ て いま す 。 ゞ が 
NULL の 場合 , tmpmam は 作成 し た テン ポラ リフ ァイル 名 を 内 部 の 静 的 オ 
プ ジ ェ クト に 残し , それ を 指す ポイ ンタ を 返し ます 。 s が NULL で な い 場 
合 は , テン ポラ リフ ァイル 名 を ゞ が 指す 配列 の 中 に 格納 し て s を 返し ます 。 


注意 : tmpnam を 使っ て テン ポラ リフ ァイル を 作成 し た 場合 , その ファ イ 
ル を 削除 する の は プロ グラ マ の 責任 で す (た と えば remove を 呼び 出す )。 
その ファ イル は 自動 的 に は 消さ れ ま せん 。 


戻り 値 s が NULL の 場合 、tmpnam は 内 部 の 静 的 オプ ジェ クト を 指す ポイ ンタ を 
返し ます 。 それ 以外 の 場合 は ゞ を 返し ます 。 


可 搬 性 tmpnam は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 。 
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ーー 
toascii 


機能 整数 を ASCII 文字 に 変換 し ます 。 


形式 int toascii(int c) ・ 


プロ ト タ イ プ ctype.h 


解説 toascii は 、 整 数 c の 下位 7 ビッ ト を クリ ア し て , ASCII 文字 に 変換 する マ 
クロ で す 。 返 され る 値 の 範囲 は 0 一 127 に な り ま す 。 


戻り 値 toaseii は c を 変換 し た 値 を 返し ます 。 


可 搬性 toascii は UNIX シス テム て 使用 で きま す 。 
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_tolower 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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文字 を 小文字 に 変換 し ます 。 


#include <ctype.h> 


int tolower(int < が): 

ctype.h 

_tolower は 、 整数 cz (範囲 は EOF255) を 小文字 (az) の 値 に 変換 す 
る マク ロ で す 。 こ れ は , cz が 大 文字 で ある と わか っ て いる と きだ け 使 用 す 
べき で す 。 

_tolower は , tolower と 同じ 変換 を 行ない ます が ,_tolower は マク ロ な の 


で , これ を 使う と き に は ctypeh を イン クル ー ド し な けれ ば な り ま せん 。 


_tolower は , c ヵ が 大 文字 の 場合 に は 変換 し た 値 を 返し ます 。 そ う で な い 場 
合 の 結果 は 未定 義 で す 。 


_tolower は UNIX シス テム て 使用 で きま す 。 
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tolower 


機能 文字 を 小文字 に 変換 し ます 。 


形式 int tolower(int < の ) : 


プロ ト タ イ プ ctypeh 


解説 tolower は 、 整数 c4 (範囲 は EOF255) を 小文字 (a 一 2) の 値 に 変換 す 
る 関数 で す 。c4 が 大 文字 の 場合 に の み 変換 が 行なわ れ , 他 の 文字 の 場合 は 
その まま で す 。 

戻り 値 tolower は 、c み が 大 文字 の 場合 に は 変換 し た 値 を 返し ます 。 そ う で な い 場 


合 に は , c% を その まま 返し ます 。 


可 搬性 tolower は UNIX シス テム て 使用 で き , ANSIC と 互換 性 が あ り ます 。K& 
R で も 定義 8 れ て いま す 。 
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_toupper 


機能 文字 を 大 文字 に 変換 し ます 。 


形式 #include <ctype.h> 
int toupper(int c が の : 


プロ ト タ イ プ ctype.h 


解説 _toupper は , 整数 を 対応 する 大 文字 の 値 に 変換 する マク ロ で す 。 こ れ 
は , ce が 小文字 で ある と わか っ て いる と きだ け 使 用 すべ き で す 。 
_toupper は toupper と 同じ 変換 を 行ない ます が , これ は マク ロ な の で , 使 
うと き に は ctype.h を イン クル ー ド し な けれ ば な り ま せん 。 


戻り 値 _toupper は , み が 小文字 の 場合 に は 変換 し た 値 を 返し ます 。 そ う で な いり 場 
合 の 結果 は 未定 義 で す 。 

可 搬性 _toupper は UNIX シス テム て 使用 で きま す 。 
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toupper 


機能 文字 を 大 文字 に 変換 し ます 。 


形式 int toupper(int c) : 


プロ ト タ イ プ ctypeh 


解説 toupper は , 整数 c ヵ (範囲 は EOF255) を 大 文字 (AZ) の 値 に 変換 す 
る 関数 で す 。c が 小文字 の 場合 に の み 変 換 が 行なわ れ , 他 の 文字 の 場合 は 
その まま で す 。 

戻り 値 toupper は 、ch が 小文字 の 場合 に は 変換 し た 値 を 返し ます 。 そ う で な い 場 


合 に は , ch を その まま 返し ます 。 


可 搬性 toupper は UNIX シス テム て 使用 で き , ANSIC と 互換 性 が あり ます 。K& 
R で も 定義 きる れ て いま す 。 
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tzset 


形式 


プロ ト タ イ プ 
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グロ ー バ ル 変 数 ggg7ig が 7 な 7zezoze, 7zg7ze の 値 を セッ ント し ます 。 


#include <time.h> 
void tzset (void) ・ 


time.h 


tzset は , 環境 変数 TZ に し た が っ て , ggg/zg お xezoe, 247ze の 
3 つの グロ ー バ ル 変 数 の 値 を セッ ト し ます 。 ラ イブ ラリ 関数 ftime と 
localtime は 、 地方 時 間 帯 が どこ で あっ て も 正しい グリ ニッ チ 標 準 時 

(GMT) を 得る た め に , この 3 つの グロ ー バ ル 変 数 を 使用 し ます 。 環 境 変 
数 TZ に 設定 され る 文字 列 の 形式 は 以下 の 通り で す 。 


TZ = zzz[+/-]d[d][111] 


を z は 現在 の 時 間 帯 の 名 前 を 表わす 3 文字 の 文字 列 で す 。3 文 字 す べ て が 必要 
で す 。 た と えば , 文字 列 "PST" は 大 平 洋 標準 時 (Pacific Standard Time) 
を 表わす た め に 使用 され ます 。 

[+/-]2[Z] は , 待 号 付き の 1 桁 以上 の 数 値 を 持つ 必須 の フィ ー ル ド で す ( 符 
号 は 正 の 値 の 場合 に は 省略 て で きま す )。 この 数 値 は , そ の 時 間 帯 と GMT と 

の 差 を 示す 時 間 数 で す 。 正 の 数 の 場合 は GMT か ら 西 に , 負 の 数 の 場合 は 
GMT か ら 東 に 向かっ て 調整 され ます 。 た と えば , この 数 が 5 で あれ ば 
EST, 十 8 な ら ば PST, -1 な ら ヨ ー ロ ッ パ 大 陸 と いう よう に な り ま す 。 この 
数 値 は 、 グ ロー バル 変数 が ezoze を 計算 する 際 に 使わ れ ま す 。 な xezoze 
は , GMT と 地方 時 間 帯 と の 差 を 秒 単位 で 保持 し て いま す 。 

分 は , 地方 時 間 和 帯 夏時間 を 表わす 省略 可能 な フィ ー ル ド で す 。 た と えば " 
PDT" は , 太平 洋 夏 時 間 (Pacific Daylight Savings Time) を 表わす た め 
に 使わ れ ま す 。 こ の フィ ー ル ド が 存在 すれ ば , グロ ー バ ル 変 数 gzg/igf は 
ゼロ で な い 値 に セッ ト さ れる こと に な り ま す 。 

環境 変数 TZ が 存在 し な いか , 存在 し て も 上 記 の よう な 形式 で は な い 場 合 、 
グロ ー バ ル 変 数 dzg/ig7。 が zezoze, zzg7ee へ 代入 する た め に , デフ ォ 


第 2 章 Turbo C ラ イブ ラリ 


ルト の TZ = "EST5EDT" が 用 いら れ ま す 。 

グロ ー バ ル 変 数 cxe[0] は 、TZ 環境 文字 列 か ら 取 り 出 し た 地方 時 間 帯 
名 の 3 文字 の 文字 列 を 指し て いま す 。gzzgze [1] は 、TZ 環境 文字 列 か ら 取 
り 出 し た 地方 時 間 簿 夏 時 間 名 を 表わす 3 文字 の 文字 列 を 指し て いま す 。 夏 時 


間 帯 名 が 無い 場合 に は , zzgxe [1] は ヌル 文字 列 を 指し ます 。 


あり ませ ん 。 


tzset は UNIX お よび XENIX シス テム て 使用 で きま す 。 


asctime, ctime, ftime,、 gmtime,、 localtime, stime, time 


#1nclude <std1ib.h> 
#1nc1ude <time.h> 


main() 
い 
time t tdi 
putenv("T2=PSTBPDT" ) : /* 太平 洋 夏 時 間 */ 
tzset()i 
time(&td): /* 現在 の 時 刻 / 日 付 を 得る */ 


Printf("Current time = Zs\n"。 asctime(1ocal1time(&td) ) ) : 
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ultoa 


形式 


プロ ト タ イ プ 


戻り 値 


関連 項目 
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unsigned long を 文字 列 に 変換 し ます 。 


char * ultoa(unsiged long yg/e, char * sg int 7 の 記 ) : 


stdlib.h 


ultoa は , ug/e の 値 を メル で 終わ る 文字 列 に 変換 し , 結果 を sg に 代入 
し ます 。 yg/ze は unsigned long 型 で す 。 

72 の が に は vg/e を 変換 する 際 に 使用 する 基底 を 指定 し ます 。 こ の 値 は 
2-36 の 値 で な けれ ば な り ませ ん 。wultoa は 、 オー バー フロ ー の チェ ッ ク は 
行ない ませ ん 。 ま た , yg/we が 負 で , ggix が 10 で ある と , 負 符号 (-) は セ 
ッ ト さ れ ま せん 。 


注意 : swing 用 に 確保 する 領域 は 、 返さ れる 文字 列 を 格納 する の に 充分 な 
大 きき で な けれ ば な り ま せん 。 ultoa が 返す の は 最大 33 文 字 で す 。 


ultoa は , sg を 返し ます 。 エ ラー の 戻り 値 は あり ませ ん 。 


itoa, ltoa 
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ungetc 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


入力 スト リー ム へ 1 文字 を プッ シュ バッ ク し ます 。 


#include <stdio.h> 
int ungetc(int c, FILE * segz) : 


stdio.h 


ungetc は 、 入力 スト リー ム seg7 に 1 文字 を 返し (プッ シュ バッ ク ) ま 
す 。szeg7 は 入力 用 に オー プン され た も の で な けれ ば な り ま せん 。 こ の 文 
字 は , 次 に s/eg に 対す る getc ある い は fread の 呼び 出し に よっ て 返さ 
れ ま す 。 文 字 1 個 は 無 条 件 で プッ シュ バッ ク す る こと が で きま す 。gete を 呼 
び 出 きず に 再び ungetc を 呼び 出す と 前 に プッ シュ バッ ク し た 文字 を 消 
し て し まう こと に な り ま す 。fflush, fseek, fsetpos., ある い は rewind の 呼 
び 出 し は ,、 プッ シュ バッ ク さ れ た 文字 の すべ て の メモ リ を 消去 し ます 。 


ungetc は , 成功 し た 場合 は アデ ッシュ バッ ク し た 文字 を 返し , 操作 に 失敗 し 
た 場合 は EOF を 返し ます 。 


ungetc は UNIX シス テム て 使用 で き , ANSI C と 互換 性 が あり ます 


fgetc、 getc、 getchar 
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ungetch 


機能 キー ポー ド バ ッ ファ に 1 文字 を プッ シュ バッ ク し ます 。 

形式 int ungetch(int c) : 

プロ ト タ イ プ conioh 

解説 ungetch は ,、 コンソ ー ル に 1 文字 を プッ シュ バッ ク し ます 。 この 文字 は 次 の 
文字 入力 で 読む こと が で きま す 。 ungetch は , 読み 込み を せ ず に 2 回 以上 続 


け て 呼び 出さ れる と エラ ー に な り ま す 。 


戻り 値 ungetch は , 成功 し た 場合 は アデ ッシュ バッ ク し た 文字 を 返し .、 エラ ー の 場 
合 は EOF を 返し ます 。 


可 搬性 ungetch は UNIX シス テム て で 使用 で きま す 。 


関連 項目 getch, getche 
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unixtodos 


機能 日 付 と 時 刻 を DOS フォ ー マ ッ ト に 変換 し ます 。 


形式 #include <dos.h> 


void unixtodos(long ye, struct date * の ,struct time *※ 7 の): 


プロ ト タ イ プ dosh 


解説 unixtodos は 、 ze の 中 に 与え られ て いる UNIX 形式 の 時 刻 を DOS 形式 
に 変換 し . @ お よび 7 が 指し て いる date お よび time 構造 体 を 埋め ます 。 


戻り 値 あり ませ ん 。 


可 搬性 unixtodos は MS-DOS に 特有 の 関数 で す 。 


関連 項目 dostounix 
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unlink 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 
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ファ イル を 削除 し ます 。 

int unlink (const char * ezg7ze) ・ 

dos.h、io.h, stdio.h 

unlink は 、/Mezg7ze で 指定 され た ファ イル を 削除 し ます 。/Mezg7ze に は 。 
DOS の ドラ イブ 名 , バス 名 , ファ イル 名 を 使う こと が で きま す 。 ワ イル ド 
カー ド は 使え ませ ん 。 

読み 出し 専用 ファ イル は , umlink の 呼び 出し で は 削除 で きま せん 。 読み 出 
し 専用 ファ イル を 削除 する に は 、 先 に chmod ある い は _chmod を 使っ て 読 
み 出 し 専用 属性 を 変更 し て お く 必 要 が あり ます 。 


unlink は , 成功 し た 場合 は 0 を 返し ます 。 エ ラー の 場合 は -1 を 返し , eryzo 
に 次 の いずれ か を セッ ト し ます 。 


ENOENT パス 名 ある い は ファ イル 名 が 見 つか ら な い 
EACCES アク セス が 拒否 され た 


unlink は UNIX シス テム て 使用 で きま す 。 


chmod, remove 


第 2 章 Turbo C ラ イブ ラリ 


unlock 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 


ファ イル シェ アリ ング ロッ ク を 解き ます 。 

int unlock(int Agzgde, long o/ が ser, long /ezg 太 ) ・ 

jo.h 

umlock は 、DOS 3.* の ファ イル シェ アリ ング 機能 へ の イン ター フェ ー ス 
を 提供 し ます 。 

unlock は , 以前 の lock の 呼び 出し で セッ ト され た ロッ ク を 解除 し ます 。 エ 
ラー を 避け る た め に は , ファ イル を クロ ー ズ する 前 に ロッ ク を 解除 し て お 
か な けれ ば な り ま せん 。 も ちろ ん ,、 ブロ グラ ム が 終了 する 前 に ロッ ク を 解 
除 し て お か な く て は な り ま せん 。 


unlock は 成功 し た 場合 は 0 を 返し 、 エラ ー の 場合 は -1 を 返し ます 。 


unlock は MS-DOS 3.* に 特有 の 関数 で す 。 こ れ よ り 前 の バー ジョ ン で は 。 
この 関数 は サポ ー ト され ませ ん 。 


lock, sopen 
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Va&_。。。 


機能 


形式 


プロ ト タ イ プ 


解説 
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可変 個 の 引数 リス ト を 実現 し ます 。 


#include <stdarg.h> 

void va _start(va_list pgzg77,/25 の 災 ) ・ 
type va_arg(va_list 7977。 の の Pe) ・ 
void va_end(va_list per が ) : 


stdargjh 


yfprintf, vprintf な どの いく つか の C 関 数 は , 固定 の 引数 リス ト に 加え 
て , 可変 個 の 引数 リス ト を と る こと が で きま す 。va_ ..、 マ クロ は , こう し 
た 引数 リス ト を アク セス する 可 搬性 の ある 方 法 を 提供 し ます 。 こ れ ら の マ 
クロ は , 呼び 出さ れ た 関数 側 で は 受け 取っ た 引数 の 個数 と 型 が だ わからない 
場合 に , 引数 リス ト を 1 つ ず つ 進 め て 行く た め に 使わ れ ま す 。 

ヘッ ダフ ァイル stdarg.h で は , 1 つの 型 (va_list) と 3 つの マク ロ (va start。 
Ya_arg,Ya end) が 宣言 され て いま す 。 


Ya_list 
この 配列 は 、va_arg と va_end が 必要 と する 情報 を 含ん で いま す 。 呼び 
出さ きれ た 関数 が 可変 の 引数 リス ト を と る と き は , その 関数 は va_list 型 
の 変数 pgrg を 宮 言 し ます 。 


Ya_start 
この ルー チン (マク ロ と し て イン プリ メン ト さ れ て いま す ) は , その 関 
数 に 渡さ れる 可変 数 の 引数 の 先頭 を pgrg が 指す よう に セッ ト し ます 。 
Ya_start は 、va_arg や va end が 使用 され る 前 に 使わ れ な けれ ば な り 
ませ ん 。 Ya_start は 2 つの 引数 grgi と /gs7 巡 を と り ま す (pgrg み に つ 
いて は 上 の Ya _list を 参照 し て くだ さい )。/gs が な は 固定 の 引数 リス ト の 
最後 の 引数 の 名 前 で す 。 
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Ya_arg 
この ルー チン (これ も マク ロ ) は , 次 に 渡さ れる べき 引数 (可変 引数 の 
1 つ ) と 同じ 型 ,、 同 じ 値 の 式 に 展開 され ます 。va_arg が 最初 に 使用 され 
る と ,、 リス ト の 最初 の 引数 が 返さ れ ま す 。 va _arg が 使用 され る ご と に , 
リス ト の 次 の 引数 が 返さ れ ま す 。 こ れ は , まず pgzg を 再 参照 し , その 
後 grggn を イン クリ メン ト し て 次 の 項 を 指す よう に し ます 。Ya_arg は , 
の pe を ,。 デリ ファ レ ン ス と 次 の 項 の 位置 づけ に 使い ます 。 以後 va_arg 
が 呼び 出 き れる た びに , リス ト 中 の 次 の 引数 を pgrg7 が 指す よう に 変更 
し ます 。 


Ya end 
この マク ロ は , 呼び 出 きれ た 関数 が 通常 の リタ ー ン を 行 な を る よう に し 
ます 。va_end は pgrg を 変更 し て 、va start が 再び 呼び 出さ れ な けれ 
ば 使 を な いよ うに し ます 。va_arg が すべ て の 引数 を 読み 終わ っ た 後 で , 
Ya_end が 呼ば れる よう に すべ き で す 。 そう で な い 場 合 は ,、 プ ログ ラム 中 
で 何 か 了 予測 で き な い こと を 引き 起こ す 可 能 性 が あり ます 。 


戻り 値 ya_start と va end は 値 を 返し ませ ん 。 ya_arg は リス ト 中 の 現在 の 引数 
(pgzg7 が 指し て いる も の ) を 返し ます 。 


可 搬性 va_arg, va start,va end は UNIX シス テム て 使用 で きま す 。 


関連 項目 Y.….Scanf, Y.…printf 
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例 1 


例 2 
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すま include <stdio.h> 
す 1nclude <stdarg.h> 


/* 0 で 終わ る リス ト の 合計 を 求め る */ 


void sum(char *meg,。 ・・・) 


( 
Int total = 0 
va_1tst api 
1nt ar&i 
Ya_start(ap,。 m8g): 
while ((arg = va_arg(ap,int)) != 0) 
total += argsi 
printE(meg, tota1): 
} 
main() 
( 
sum("The total of 1+2+3+4 5 dn*。 1。 2。 3。 4。 0)5 
} 
プロ グラ ム 出 力 


The total of 1+2+3+4 1e 10 


ncude <stdlo.h> 
nc1ude <stdarg.h> 


Yotd error(char *Eormat。 ・.) 


{ 
Ya_1ist ar&ptri 
PrintE("errori "): 
Ya_stsrt(argptr。 Format): 
YPrintf(Eormat。 argPtr)i 
Ya_end (argptr): 
} 
matn() 
い 
nt value = -1: 
error("this 1s just an error message\n"): 
error("nva1id value Zd encountered\n* 。 value)s 
} 
プロ グラ ム 出 力 


errorithis Ss just an error message 
erroriin va1id value -1 encoutered 
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vfprintf 


機能 スト リー ム に 書式 つき 出力 を 書き 込み ます 。 


形式 #include <stdio.h> 
int vfprintf(FILE * segzz, const char 玉 /ozzg7。 va_list gzg/s7) ・ 


プロ ト タ イ プ stdioh 


解説 Y…printf 関数 は ,. printf 関数 の 別 の エン トリ ポイ ント と し て 知ら れ て 
いま す 。 こ れ ら は , 対応 する ...primtf と ほとん ど 同 じ よ うに 動作 し ます 
が v.….printf 関数 は , 引数 リス ト で は な く , 引数 リス ト へ の ポイ ンタ を 受 
け 入 れ ま す 。 
Yfprintf は , 引数 の 並び へ の ポイ ンタ grg57 を 受け 取り , /oryzg7 に よっ て 
指 さ れ る 書式 文字 列 中 の 書式 指定 を 各 引 数 に 適用 し て , 書式 化 さ れ た デー 
ク を 指定 され た スト リー ム に 出力 し ます 。 書 式 指定 の 数 は , 引数 と 同じ だ 
け な け れ ば な り ま せん 。 
書式 指定 に 関す る 詳細 な 情報 に つい て は , printf の 解説 を 参照 し て くだ さ 


い 。 


戻り 値 Yfprintf は , 出力 し た な バ イト 数 を 返し ます 。 エラ ー の 場合 は EOF を 返し ま 
す 。 
可 搬性 Yfprintf は UNIX シス テム V て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 


関連 項目 printf. va .… 


例 printf を 参照 し て くだ さい 。 


45Z 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬 性 


関連 項目 
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スト リー ム か ら 書 式 つき 入力 を 行ない ます 。 


#include <stdio.h> 
int vfscanf(FILE * s/eg、 const char * 7orzz7。 Va_ list grg/57) ・ 


stdio.h 


Y…scanf の 関数 は ,. scanf 関数 へ の 別 の エン トリ ポイ ント と し て 知ら 
れ て いま す 。 こ れ ら は , 対応 する ...scanf と ほとん ど 同 じ よ うに 動作 し ま 
す が , Y.….scamf 関数 は 、 引数 リス ト で は な く , 引数 リス ト へ の ポイ ンタ を 
受け 入れ ます 。 

Yfscanf は , 一 連 の 入力 フィ ー ル ド を スキ ャ ン し て , 一 度 に 1 文字 ずつ スト 
リー ム か ら 文字 を 読み 込み ます 。 次 に , 引数 przzg7 に よっ て 指 さ れ る 書式 
文字 列 中 の 書式 指定 に し た が っ て , 各 フ ィ ー ル ド を 書式 化し ます 。 最 後に , 
の g が 7 が 指し て いる リス ト 中 の 各 ア ドレ ス に , 書式 化し た 入力 を 格納 し て 
いき ます 。 書 式 文字 列 中 の 書式 指定 の 個数 は , grg/s7 が 指す サリ スト 中 の ア 
ドレ ス の 数 と 同じ で な けれ ば な り ま せん 。 

書式 指定 も 含め て , 詳細 な 情報 に つい て は scanf の 解説 を 参照 し て くだ さ 
い 。 
Yfscanf は , 通常 の フィ ー ル ド の 終了 (ホワ イト スペ ー ス ) に 達する 前 に 。 
フィ ー ル ド の スキ ャ ン を や め る 場合 が あり ます 。 ま た , いく つか の 理由 か 
ら 入 力 を 終了 し て し まう こと も あり ます 。 こ うし た 問題 に つい て は scanf 


の 解説 を 参照 し て くだ さい 。 

Yfscanf は , 正しく スキ ャ ン し , 変換 し , 格納 し た 入力 フィ ー ル ド の 数 を 返 
し ます 。 戻 り 値 に は , 値 を 格納 し な か っ た 入力 フィ ー ル ド の 数 は 含ま れ ま 
せん 。 値 を 格納 し た フィ ー ル ド が な か っ た 場合 は 戻り 値 は 0 に な り ま す 。 


Yfscanf は UNIX シス テム V て 使用 で きま す 。 


fscanf, scanf, va .…. 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


vprintf 


機能 sog7 に 書式 つき 出力 を 書き 出し ます 。 


形式 #include <stdarg.h> 
int vprintf(const char * /o7zg7。 yg が 57 7g7 が 57) ・ 


プロ ト タ イ プ stdioh 


解説 Y.…printf 関数 は , .. printf 関数 の 別 の エン ト リポ イン ト と し て 知ら れ て 
いま す 。 こ れ ら は , 対応 する ...printf と ほとん ど 同 じ よ うに 動作 し ます 
が , v.…printf 関数 は , 引数 リス ト で は な く 、 引 数 リス ト へ の ポイ ンタ を 受 
け 入 れ ま す 。 
Yprintf は , 引数 の 並び へ の ポイ ンタ eg57 を 受け 取り , orig7 に よっ て 
指 さ れる 書式 文字 列 中 の 書式 指定 を 各 引 数 に 適用 し て , 書式 化 さ れ た デー 
タ を sgo7 に 出力 し ます 。 書式 指定 の 数 は , 引数 と 同じ だ け な け れ ば な り 
ませ ん 。 
書式 指定 に 関す る 詳細 な 情報 に つい て は , printf の 解説 を 参照 し て くだ さき 


い 。 


戻り 値 Yprintf は , 出力 し た バイ ト 数 を 返し ます 。 エ ラー の 場合 は OF を 返し ま 
す 。 
可 搬性 Yprintff は UNIX シス テム V て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 


関連 項目 printf, va .… 


例 printf を 参照 し て くだ さい 。 
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vscanf 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 
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si か ら 書 式 つ き 入 力 を 行ない ます 。 


int vscanf(const char * /oyzzg7。 yg 7 が 7 grg7 が 7) 


stdio.h 


Y…scanf の 関数 は , .……scanf 関数 へ の 別 の エン トリ ポイ ント と し て 知ら 
れ て いま す 。 こ れ ら は , 対応 する ...scanf と ほとん ど 同 じ よ うに 動作 し ま 
す が , Y.…scamf 関数 は , 引数 リス ト で は な く , 引数 リス ト へ の ポイ ンタ を 
受け 入れ ます 。 

Yscanf は 、 一 連 の 入力 フィ ー ル ド を スキ ャ ン し て , 一 度 に 1 文字 ずつ sr 
か ら 文字 を 読み 込み ます 。 次 に 、 引数 orzzg7 に よっ て 指 さ れ る 書式 文字 列 
中 の 書式 指定 に し た が っ て , 各 フ ィ ー ル ド を 書式 化し ます 。 最後 に 、 gg/7 
が 指し て いる リス ト 中 の 各 ア ドレ ス に , 書式 化し た 入力 を 格納 し て いき ま 
す 。 書 式 文字 列 中 の 書式 指定 の 個数 は 、 grg/7 が 指す リス ト 中 の アド レス 
の 数 と 同じ で な けれ ば な り ま せん 。 

書式 指定 も 含め て , 詳細 な 情報 に つい て は scanf の 解説 を 参照 し て くだ さ 


い 。 
Yscanf は 正しく スキ ャ ン し , 変換 し , 格納 し た 入力 フィ ー ル ド の 数 を 返 
し ます 。 戻り 値 に は , 値 を 格納 し な か っ た 入力 フィ ー ル ド の 数 は 含ま れ ま 
せん 。 値 を 格納 し た フィ ー ル ド が な か っ た 場合 は , 戻り 値 は 0 に な り ま す 。 


Yscanf は UNIX シス テム V て 使用 で きま す 。 


fscanf, scanf, va ... 
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Ysprintf 


機能 文字 列 へ 書式 つき 出力 を 書き 込み ます 。 


形式 int vsprintf(char * 7er, const char * 7oyzg7。 va_list gg/57) : 


プロ ト タ イ プ stdioh 


解説 Y…printf 関数 は , printf 関数 の 別 の エン ト リポ イン ト と し て 知ら れ て 
いま す 。 これら は , 対応 する ...printf と ほとん ど 同 じ よ うに 動作 し ます 
が , vprintf 関数 は , 引数 リス ト で は な く , 引数 リス ト へ の ポイ ンタ を 受 
け 入 れ ま す 。 
Ysprintf は , 引数 の 並び へ の ポイ ンタ erg が 57 を 受け 取り , /orzg7 に よっ て 
指 さ れる 書式 文字 列 中 の 書式 指定 を 各 引 数 に 適用 し て , 書式 化 さ きれ た デー 
タク を 文字 列 * 7ey に 書き 込み ます 。 書式 指定 の 数 は 引数 と 同じ だ け な 
けれ ば な り ま せん 。 
書式 指定 に 関す る 詳細 な 情報 に つい て は , printf の 解説 を 参照 し て くだ さ 


い 。 


戻り 値 Ysprintf は , 出力 し た バイ ト 数 を 返し ます 。 エ ラー の 場合 は EOF を 返し ま 
入る 
可 搬性 Ysprintf は UNIX シス テム V て 使用 で き 、 ANSI C と 互換 性 が あり ます 。 


関連 項目 printf, va .… 


例 printf を 参照 し て くだ さい 。 
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Ysscanf 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


462 


文字 列 か ら 書式 つき 入力 を 行ない ます 。 


int vsscanf(const char * が 77er, const char * /ozzzg7, va_list 97g/57) ・ 


stdio.h 


Y…8canf の 関数 は ,.….scanf 関数 へ の 別 の エン トリ ポイ ント と し て 知ら 
れ て いま す 。 こ れ ら は , 対応 する ...scanf と ほとんど 同 じ よ うに 動作 し ま 
す が , Y.…scanf 関数 は , 引数 リス ト で は な く , 引数 リス ト へ の ポイ ンタ を 
受け 入れ ます 。 

Ysscanf は 一 連 の 入力 フィ ー ル ド を スキ ャ ン し て , 一 度 に 1 文字 ずつ 文字 
列 * 7e か ら 文 字 を 読み 込み ます 。 次 に , 引数 76zg7 に よっ て 指 さ れる 
書式 文字 列 中 の 書式 指定 に し た が っ て , 各 フ ィ ー ル ド を 書式 化し ます 。 最 
後に , grg/57 が 指し て いる リス ト 中 の 各 ア ドレ ス に , 書式 化し た 入力 を 格 
納 し て いき ます 。 書 式 文字 列 中 の 書式 指定 の 個数 は , gs7 が 指す リス ト 
中 の アド レス の 数 と 同じ し で て な けれ ば な り ま せん 。 

書式 指定 も 含め て , 詳細 な 情報 に つい て は scanf の 解説 を 参照 し て くだ さ 
い 。 


Ysscanf は , 正しく スキ ャ ン し , 変換 し , 格納 し た 入力 フィ ー ル ド の 数 を 返 
し ます 。 戻り 値 に は , 値 を 格納 し な か っ た 入力 フィ ー ル ド の 数 は 含ま れ ま 
せん 。 値 を 格納 し た フィ ー ル ド が な か っ た 場合 は , 戻り 値 は 0 に な り ま す 。 
文字 列 の 終わ り を 読み 込ん だ 場合 に は EOF を 返し ます 。 


Ysscanf は UNIX シス テム V て 使用 で きま す 。 


fscanf, scanf, va 
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_write 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


ファ イル へ の 書き 込み を 行ない ます 。 
int write(int Agzge、 void * が 7, unsigned /ez) : 
io.h 


_write は 、 が 7 が 指し て いる バッ ファ か ら /eg バイ ト を , 4gzde に 結び つ 
けら れ て いる ファ イル ある い は デバ イス に 書き 込み ます 。 4gzg/e は , 
creat。 open,、 dup, dup2 の 呼び 出し で 得 ら れ た ファ イル ハン ドル で す 。 
_write に よっ て 書き 込め る の は 最大 65534 バ イト で す 。65535 (0xFFFF) 
は -1 と 同じ で あり , エラ ー を 返す た め に 使用 され ます 。 

_write が 扱う ファ イル は すべ て バイ ナリ ファ イル な の て で , 改行 文字 (LF) 
を CR/LF に 置き 換え る こと は し ませ ん 。 

実際 に 書き 込ま れ た バイ ト 数 が 指定 より 小さ い 場合 は 、 エラ ー (お そら く 
ディ スク が いっ ぱい に な っ た ) を 意味 し て いる と 考え る べき で す 。 

ディ スク 上 の ファ イル に 対し て は , 書き 込み は 常に ファ イル ポイ ンタ の 現 
在 位置 (lseek を 参照 ) か ら 行 な われ ます 。 デバ イス に 対し て は , その デバ 
イス へ バイ ト が 直接 送ら れ ま す 。 

O_APPEND オプ ショ ン で オー プン され た ファ イル に 対し て , write は , 
書き 込み の 前 に た ファ イル ポイ ンタ を EOF まで 移動 させ ませ ん 。 


_write は , 書き 込ん た だ バイ ト 数 を 返し ます 。 エ ラー の 場合 は -1 を 返し 、 グ 
ロー バル 変数 er7zzo に 次 の いずれ か を セッ ト し ます 。 


EACCES アク セス が 否定 され た 
EBADF ファ イル 番号 が 正しく な い 


_write は MS-DOS 特有 の も の で す 。 


lseek, read, write 
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機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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ファ イル に 書き 込み を 行ない ます 。 


int write(int gzg7e, void * 7, unsigned /ez) : 


io.h 


write は , 7 が 指す バッ ファ か ら ez バイト を , gz の に 結び つけ られ て 
いる ファ イル ある い は デバ イス に 書き 込み ます 。 4gzge は 、 creat, 
open,。 dup, dup2 の 呼び 出し で 得 ら れ た ファ イル ハン ドル で す 。 

テキ スト ファ イル に 書き 込み を 行なう ときには, ファ イル に 実際 に 書き 込 
まれ る バイ ト 数 が 指定 し た 数 を 越 を る こと が あり ます 。 

write に よっ て 書き 込め る の は 最大 65534 バ イト で す 。65535 (0xFFFF) は 
-1 と 同じ で あり , これ は エラ ー を 返す た め に 使用 され ます 。 

テキ スト ファ イル で は 。 改行 文字 (LF) が ある と , write は CR/LF に 置 
き 換 えて 出力 し ます 。 

実際 に 書き 込ま れ た バイ ト 数 が 指定 より 小さ い 場 合 は 、 エラ ー (お そら く 
ディ スク が いっ ぱい に な っ た ) を 意味 し て いる と 考え る べき で す 。 

ディ スク 上 の ファ イル に 対し て は , 書き 込み は 常に ファ イル ポイ ンタ の 現 
在 位置 (lseek を 参照 ) か ら 行なわ れ ま す 。 デ バイ ス に 対し て は ,、 その デバ 
イス へ バイ ト が 直接 送ら れ ま す 。 

O_APPEND オプ ショ ン で オー プン され た ファ イル に 対し て は , write は , 
ファ イル ポイ ンタ を EOF まで 移動 し て か ら デ ー タ を 書き 込み ます 。 


write は 、 書き込ん だ バイ ト 数 を 返し ます 。 テ キス ト フ ァイル に 対す る 
write で は , 生成 され た CR の 数 は カウ ント され ませ ん 。 エ ラー の 場合 は 


-1 を 返し , errzo に 次 の いずれ か を セッ ト し ます 。 


EACCES アク セス が 否定 され た 
EBADF ファ イル 番号 が 正しく な い 


write は UNIX シス テム て 使用 で きま す 。 
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関連 項目 creat, lseek, open, read, write 
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テキ スト ビデ オ 関 数 リフ ァ レ ンス 


この 節 に まとめ られ て いる の は , テキ スト ウィ ンド ウ の 制御 な ど を 行なう 関数 で す 。 こ 
れ ら は , その 対象 の 機種 (PC-9801 シ リー ズ , ある い は IBM PC と その 互換 機 ) で し か 
動作 し ませ ん の て 注意 し て くだ さい 。 

この 節 で 解説 し て いる ルー チン の ほか に , テキ スト ウィ ンド ウ に 対し て 入出 力 を 行なう 
4 つの 関数 , cprintf, cputs, getche, putch が あり ます 。 こ の 4 つ に つい て は , 前 の 
「Turbo C 標準 関数 リフ ァ レ ンス 」 を 見 て くだ さい 。 


clreol 
機能 テキ スト ウィ ンド ウ 内 で , 行末 まで を 消去 し ます 。 
形式 void clreol(void) : 


プロ ト タ イ プ conioh 


解説 clreol は . カ レン ト テ キス トウ ィ ン ド ウ に お いて , カー ソル の 位置 か ら 行末 
まで の すべ て の 文字 を 消去 し ます 。 カーソル は 移動 し ませ ん 。 


戻り 値 あり ませ ん 。 

可 搬性 clreol は 、 PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 
し ます 。 

関連 項目 clrscr, delline、window 
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clrscr 


機能 テキ スト ウィ ンド ウ を クリ ア し ます 。 
形式 void clrscr (void) : 
プロ ト タ イ プ conioh 


解説 clrscr は 、 カレ ント テキ スト ウィ ンド ウ を クリ ア し , カー ソル を ウィ ンド 
ウ の 左上 端 (1.1) に 位置 づけ ます 。 


戻り 値 あり ませ ん 。 

可 搬性 clrscr は , PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 
し ます 。 

関連 項目 clreol、 delline,. window 
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プロ ト タ イ プ 


解説 


戻り 値 


可 搬 性 


関連 項目 


468 


テ チキ スト ウィ ンド ウ 内 で 1 行 を 削除 し ます 。 

void delline (void) : 

conio.h 

delline は , カー ソル が ある 行 を 削除 し , その 下 に ある すべ て の 行 を 1 行 上 に 
ずら し ます 。 delline は , 現在 アク ティ プ な テキ スト ウィ ンド ウ に 対し て 実 
行き され ます 。 


あり ませ ん 。 


deline は , PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 
し ます 。 


clreol,clrscr,inslinewindow 
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gettext 


検 能 


形式 


プロ ト タ イ プ 


解説 


テキ スト モー ド 画 面 中 の テキ スト を メモ リ に 格納 し ます 。 


int gettext(int //7, int 7op, int 77g77。 int の o77o77, VOid 玉 の es) 


conio.h 


gettext は 、 始 点 (77.7op) と 終点 (gz.2o77o7z) で 指定 され る 画面 上 の 
長方形 の 内 容 を , 引数 desz が 指す メモ リ 上 の バッ ファ に 格納 し ます 。 

4 つの 座標 は 、 すべ て 画面 絶対 座標 で 指定 し ます (ウィ ンド ウ 相 対 座標 で は 
あり ませ ん )。 画 面 の 左上 隅 の セル が (1.,1) で す 。 

gettext は , 画面 イメ ー ジ デー タ を 、 左 か ら 右 へ , また 上 か ら 下 へ 順に バッ 
ファ に 格納 し て いき ます 。 


PC-9801 で は , 格納 領域 es の サイ ズ ( バ イト 数 ) は 大 の よう に な り , 最 
低 限 こ れ だ け は 確保 する こと が 必要 で す 。 


モー ド 行 数 桁 数 属性 
80 桁 (oo 一 7 の p 十 1)X (Zg77 一 7 十 1)X4 
40 桁 (2oo7 一 7 の pp 十 1)X (7g 一 eg7 填 1)X8 


画面 イメ ー ジ と 格納 領域 の 関係 は 克 の よう に な り ま す 。 


画面 イメ ー ジ 


/e77 
+ 


7op 一 | abBef 
AdcC 


トー 2o7/o77 
ィ 


7g77 
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田 80 桁 モ ー ド の 場合 : 


(2o77o-7 の p 十 1) * (7ig が 7-e77 十 1) ネ 4 バ イト 


des | abBef : aaaaaa ! AcdC aaaaaa … 


| ご 2 バイ ト 


EEEZGIEIEIOIEIEBTIEPIETIETIETIET 


(文字 格納 領域 ) (属性 格納 領域 ) 


罰 40 桁 モー ド の 場合 : 


(ogo7-7Op 十 1) * (7g が 7-e77 十 1) *※8 バ イト 


gesz | abBef : : AcdC aaaaaa … 


aaaaaa 


EinmnronitrnrrcmCG 


(文字 格納 領域 ) 


デー2 バ イ ト 
RESSEPESSREESEYSETRETSETETRERSESI 


(属性 格納 領域) 


E1 : 文字 属性 xx : 不定 


IBM PC で は , 画面 上 の 1 セル は 、 メ モリ 上 で は 2 バイ ト を 占め ます 。 第 1 バ 
イト が セル 中 の 文字 , 第 2 バイ ト が その ビデ オ 属 性 で す 。 し た が っ て , 画面 
イメ ー ジ に 対し て 必要 と され る 格納 領域 の サイ ズ は , 桁 数 を w, 行 数 を ヵ 
と する と , 次 の よう に し て 求め る こと が で きま す 。 


バイ ト 数 = ニム X wx2 
戻り 値 gettext は 成功 し た と き は 1 を 返し ます 。 エ ラー の 場合 (た と えば , カレ 


ント テキ スト モー ド で 設定 され て いる 行 数 桁 数 を 越え る 範囲 が 指定 され 
た 場合 な ど ) に は 0 を 返し ます 。 
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可 搬 性 gettext は , PC-9801 シ リー ズ ( ま た は IBM PC と その BIOS レベ ルク の 互換 
機 ) で の み 動 作 し ます 。 


関連 項目 movetext、 puttext 
例 nc1ude <conto.h> 
main() 


6 
char buf [20*10*2]: 


gettext(1。 1, 20。 10。 buf)i /* 画面 の 一 部 を セー ブ */ 
7 な ォ / 


puttext(1。 1。 buf): /* 画面 を 回 復 */ 
} 
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gettextinfo 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 
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テキ スト モー ド ビ デ オ 情 報 を 得 ま す 。 


#include <conio.h> 


void gettextinfo(struct text info ※ ァ ) : 


conio.h 


gettextinfo は , カレ ント ビデ オ テ キ スト 情報 を 引数 で 指 さ れる 構造 体 
text_info に 格納 し ます 。 
text info 構造 体 は . ヘ ッ ダ ファ イル conio.h の 中 で 次 の よう に 定義 され て 


いま す 。 


struct text nfo { 


unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


unsigned 

unsigned 

unsigned 

unsigned 
): 


char 
char 
char 
char 
char 
char 
char 


char 
char 
char 
char 


winleftsi 
wintopi 
winrighti 
winbottomi 
attributei 
normattr: 
Currmodei 


screenheighti 
screenw1dthi 
Curxi 

curyi 


/* 
/* 
/* 
/* 
/* 
/* 
/* 


/* 
/* 
/* 
/* 


ウィ ンド ウ の を 座標 */ 
ウィ ンド ウ の 上 座標 */ 
ウィ ンド ウ の 右 座標 */ 
ウィ ンド ウ の 下 上 標 */ 
現在 の 文字 属性 */ 
通常 の 文字 属性 */ 
PC-9801 で は , 

VL/BG 8025,8020,4025,4020 
TBM PC で は , 

BW80, Bw80, C40, C80 */ 
画面 の 上 限 の 高 さ */ 
画面 の 上 限 の 幅 */ 
カレ ント ウィ ンド ウ 中 で の X 座 標 */ 
カレ ント ウィ ンド ウ 中 で の Y 護 標 */ 


構造 体 の メン バ gz は 現在 表示 し て いる 画面 の ペー ジ 番 号 で ,、 ウィ ンド 


ウ の 大 きき , 


あり ませ ん 。 


文字 属性 . カー ソル 情報 は ペー ジ 分 あり ます 。 


た だ し 結果 は / が 指し て いる 構造 体 に 格納 され ます 。 


gettextinfo は 、 PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 


動作 し ます 。 
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例 


wherey、window 


#include <conio.h> 


vold main() 


{ 


int banki 
struct text info tinfi 


gettextinfo(&tinE)i 
1f (tlnf.currmode & 0x04) 
cprintE(* 簡 易 グ ラフ バタ ー ン 有効 モー ド "): 
else 
cprintf(" バ ー チ カル ライ ン 有 効 モ ー ド "): 
1f (tinf.currmode & 0x02) 
cprintE("40 桁 X ")5 
else 
cprintf("80 桁 X ")』 
Hf (tinf.currmode & 0x01) 
cprintE(*2 0 行 \rn*)i 
elee 
cprintf(*2 5 行 \r\n*): 
cprintf(" 画 面 の 高 さ =Zd ", tlnf.screenhe1ght ) : 
cprintf(* 画 面 の 幅 =Xd\r\n* 。 tinf.screenw1dth ) : 
bank = tinf.banki 
cprintf(" ウ ィ ン ド ウ の 始点 (Zd,Zd) 終点 (Zd,Zd) \rn"。 
tinf.win1eft[bank] , tinf.wintop[ bank], 
tinf.winright[bank] , tinf.winbottom[ bank] ) : 
cprintf(" 現 在 の テキ スト 表示 属性 =702X *。 
tinf.attribute[ bank] ) : 
cprintf(" 省 略 時 の テキ スト 表示 属性 =X02X\r\n* 。 
tinf.normattr[bank] ): 
cprintf("* カ ー ソ ル 座 振 (7d,Zd) \r\n* 。 
tinf.curx[bank] , tinf.cury[bank] ): 
1f (tinf.cursor[bank] & 0x02) 
cprintf(" カ ー ソ ル 静 止 中 "): 
elee 
cprintE(* カ ー ソ ル 点 減 中 "): 
1E (tinf.cursor[bank] & 0x01) 
cprintE(" カ ー ソ ル 表 示 中 \rn*): 
elee 
cprintE(" カ ー ソ ル 博 去 中 \r\n*): 


/* 現在 の 設定 を 得る */ 


テキ スト ビデ オ 関 数 リフ ァ レ ンス 
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gOtoxy 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


例 
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テキ スト ウィ ンド ウ 内 の カー ソル を 位置 づけ ます 。 
void gotoxy(int *, int y) : 
conio.h 


gotoxy は ,、 カレ ント テキ スト ウィ ンド ウ の 指定 され た 位置 に カー ソル を 
動か し ます 。 座標 が 不適 当 な 場合 gotoxy の 呼び 出し は 無視 され ます 。 た 
と えば , (35.25) が ウィ ンド ウ の 右 下 隅 の 座標 で ある の に , gotoxy (40.30) 
と 呼び 出す こと は 不可 能 で す 。 

あり ませ ん 。 


gotoxy は , PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 
し ます 。 こ れ に 対応 する 関数 は Turbo Pascal 4.0 に も あり ます 。 


wherex, wherey, window 


gotoxy(10,20): /* カー ソル を (10,20) に 填 く */ 
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highvideo 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


高 度 文字 を 選択 し ます 。 


void highvideo (void) : 


conio.h 


PC-9801 シ リー ズ で は , highvideo は な ん の 動作 も し な い ダ ミー 関数 で す 。 


IBM PC で は highyideo は 、 現在 選択 され て いる フォ アグ ラウ ンド 色 の 高 

輝度 ビッ ト を セッ ト す る こと に よっ て , 高 交 度 文字 を 選択 し ます 。 

この 関数 の 呼び 出し は , 以降 に 呼び 出さ れる 直接 コン ソー ル 入 出力 関数 
(cprintf な ど ) が 出力 する 文字 に の み 影 響 を 与え を ます 。 す で に 画面 に 表示 

され て いる 文字 , お よび printf な どの 標準 入出 力 ス トリ ー ム を 使用 する 関 

数 が 出力 する 文字 に は 影響 を 与え を ませ ん 。 


あり ませ ん 。 

PC-9801 シ リー ズ で は , IBM PC と の 互換 性 の た め に エン トリ だ けが 用 意 
され て いま す 。 

IBM PC 版 で は , IBM PC お よび その 互換 機 で の み 動作 し ます 。 

これ に 対応 する 関数 は Turbo Pascal に も あり ます 。 


lowvideo, normvideo, textattr, textcolor 
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insline 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 
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テキ スト ウィ ンド ウ 内 て 空 行 を 挿入 し ます 。 

void insline (void) : 

conio.h 

inslime は , テキ スト ウィ ンド ウ 内 の カー ソル が ある 位置 に 空 行 を 挿入 し ま 
す 。 補 行 の 下 に ある 行 は すべ て 1 行 下がり , 最 下 行 は ウィ ンド ウ の 下 に 消え 
ます 。 

IBM PC で は , 挿入 され る 行 に は 現在 の バッ ク グ ラウ ンド 色 が 用 いら れ ま 
ず > 

inslime は 、 テキ スト モー ド て 使用 され ます 。 


あり ませ ん 。 


insline は 、 PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 
し ます 。 これ に 対応 する 関数 は Turbo Pascal 4.0 に も あり ます 。 


delline、window 
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lowvideo 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 


低 弥 度 文 字 を 選択 し ます 。 


void lowvideo (void) ・ 


conio.h 


PC-9801 シ リー ズ で は , lowvideo は 何 の 動作 も し な い ダ ミー 関数 で す 。 


IBM PC で は lowyideo は , 現在 選択 され て いる フォ アグ ラウ ンド 色 の 高 

輝度 ビッ ト を クリ ア す る こと に よっ て , 低 度 文字 を 選択 し ます 。 

この 関数 の 呼び 出し は 、 以降 に 呼び 出さ れる 直接 コン ソー ル 入 出力 関数 
(cprintf な ど ) が 出力 する 文字 に の み 影 響 を 与え ます 。 す で に 画面 に 表示 

され て いる 文字 , お よび printf な どの 標準 入出 力 ス トリ ー ム を 使用 する 関 

数 が 出力 する 文字 に は 影響 を 与え ませ ん 。 


あり ませ ん 。 

PC-9801 シ リー ズ で は , IBM PC と の 互換 性 の た め に エン トリ だ けが 用 意 
され て いま す 。 

IBM PC 版 で は , IBM PC お よび その 互換 機 で の み 動 作 し ます 。 

これ に 対応 する 関数 は Turbo Pascal に も あり ます 。 


highvideo, normvideo, textattr、textcolor 
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movetext 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


478 


画面 上 の テキ スト 領域 を 別 の 領域 に コピ ー し ます 。 


int movetext(int 77, int 7op, int 77g7, int 2o77oz7。 
int の es/e/7, int の es7/op) : 


conio.h 


movetext は 、/e77, 7op, 7g47。 ofo7: で 定義 され る 画面 上 の 長方形 領域 の 
肉 容 を , 同じ 形 の 別 の 領 城 に コピ ー し ます 。 っ ピー 先 の ブロ ッ ク の 左上 了 曲 
の 位置 は (des/e77,es7/op の ) で 与 た られ ます 。 

すべ て の 座標 は 画面 上 の 絶対 座標 で 表わし ます 。2 つ の 領域 が オー バー ラッ 
プ し て いる 場合 に も , 正しく コビー が 行なわ れ ま す 。 

movetext は 直接 ビデ オ 出 力 を 行なう テキ スト モー ド 関 数 で す 。 


movetext は 、 コ ピー が 成功 し た と き に 0 以外 の 値 を 返し ,、 コピ ー に 失敗 し 
た と き (現在 の 画面 モー ド の 範囲 を 越え る 座標 を 指定 し た と き な ど ) に は 
0 を 返し ます 。 


movetext は 、PC-9801 シ リー ズ ( ま た は IBM PC と その BIOS レベ ル の 互 
換 機 ) で の み 動作 し ます 。 


gettext, puttext 


/* を 上 隅 (5,15), 右 下 陽 (20.25) の 領域 を , 
新しい 左上 隅 (10,20) に コピ ー す る に 
movetext(5。 15。 20。 25。10, 20)』 
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normvideo 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


画面 の 表示 属性 を デフ ォ ル ト に 戻し ます 。 


void normvideo (void) ・ 


conio.h 


mormvideo は 、 画面 の 表示 属性 の 設定 を (プロ グラ ム が 実行 を 開始 し た と 

き の ) デフ ォ ル ト の 状態 に 戻し ます 。 デ フォ ルト の 状態 は 構造 体 text 

_info の zoyzig7 ケ 7 に セッ ト さ れ て いる も の で す (gettextinfo を 参照 )。 

この 関数 の 呼び 出し は , 以降 に 呼び 出さ れる 直接 コン ソー ル 入 出力 関数 
(cprintf な ど ) が 出力 する 文字 に の み 影 響 を 与え ます 。 す て に 画面 に 表示 

され て いる 文字 お よび printf な どの 標準 入出 力 ス トリ ー ム を 使用 する 関 

数 が 出力 する 文字 に は 影響 を 与え ませ ん 。 


あり ませ ん 。 


normvideo は , PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 
動作 し ます 。 こ れ に 対応 する 関数 は Turbo Pascal に も あり ます 。 


highvideo, lowvideo, textattr, textcolor 
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puttext 


機能 


形式 


プロ ト タ イ プ ブ 


解説 


戻り 値 


可 搬性 


関連 項目 


480 


メモ リ か ら 画 面 上 に テキ スト を コピ ー し ます 。 


int puttext(int /g77, int 7 の p, int 7g77, int 297 の 7 void *※ soz7ce) : 


conio.h 


puttext は gettext に よっ て 格納 され た soyce が 指す メモ リ 領 域 の 内 容 
を , 始点 (/@7.7gp) と 終点 (7jg が 7,oo) で 指定 され る 画面 上 の 長方形 に 
復元 し ます 。 

座標 は すべ て , 画面 絶対 座標 で 指定 し ます (ウィ ンド ウ 相 対 座標 で は あり 
ませ ん )。 画 面 の 左上 隅 が (1.1) で す 。 

puttext は 、 メ モリ 領域 の 先頭 か ら 画面 上 の 長方形 領域 へ , 左 か ら 右 へ , ま 
た 上 か ら 下 へ 順に テキ スト を 復元 し ます 。 


puttext は 。 成功 し た と き は 0 以外 の 値 を 返し ます 。 エ ラー が あっ た 場合 (た 
と そえ ば, カレ ント テキ スト モー ド て で 設定 され て いる 行 数 、 桁 数 を 越え る 範 
囲 が 指定 され た と き な ど ) に は 0 を 返し ます 。 


puttext は 、PC-9801 シ リー ズ ( ま た は IBM PC と その BIOS レベ ル の 互換 
機 ) で の み 動 作 し ます 。 


gettext, movetext, window 
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textattr (PC-9801) 


機能 テキ スト 属性 を セ モット し ます 。 


形式 void textattr(int zewg/ か ) : 


プロ ト タ イ プ conioh 


解説 textattr は 1 回 の 呼び 出し て 文字 の 色 , 縦 線 の 有無 , 下線 の 有無 , 反転 の 
指示 , 点滅 の 指示 な どの 属性 を 設定 する こと が で きま す 。 
この 関数 の 呼び 出し は , 以降 に 呼び 出さ れる 直接 コン ソー ル 入 出力 関数 
(cprintf な ど ) が 出力 する 文字 に の み 影 響 を 与え を ます 。 す で に 画面 に 表示 
きれ て いる 文字 . お よび printf な どの 標準 入出 力 スト リー ム を 使用 する 関 
数 が 出力 する 文字 に は 影響 を 与え を ませ ん 。 
引数 zewgf/ の 各 ビ ッ ト の 意味 は 次 の よう に な っ て いま す 。 


b7 。 b6 b5 b3 b2 bl b0 


b4 
LcIR|B Ngd 


G 緑 の 発色 (1 の と き 有 効 ) 
R 赤 の 発色 (1 の と き 有 効 ) 
B 至 の 発色 (1 の と き 有 効 ) 
VLBG textmode で VLxxxx モー ド が 指定 され て いる 場合 に は 


縦 時 線 添付 の 指示 を 意味 し 、BGxxxx モー ド が 指定 され て 
いる 場合 に は グラ フィ ッ ク 文 字 の 表示 の 指示 を 意味 し ます 


(1 の と き 有 効 )。 
UL 下線 添付 の 指示 (1 の と き 有 効 ) 
RV 反転 表示 の 指示 (1 の と き 有 効 ) 
BK 点滅 表示 の 指示 (1 の と き 有 効 ) 
SC 隠し 表示 の 指示 (0 の と き 有 効 ) 
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ベッ ダフ ァイル conio.h 内 に は 下記 の よう に 属性 が 定義 きれ て いま す 。 


定数 名 値 意味 

T BLACK 0x00 時 

T BLUE Ox20 青 

T GREEN Ox80 待 

T CYAN OxA0 水色 

T RED 0x40 赤 

T MAGENTA Ox60 柴 

T BROWN OxCO 黄色 (T YELLOW と 同じ ) 
T LIGHTGRAY OxEO 白 (T WHITE と 同じ ) 
T DARKGRAY Ox00 黒 (T BLACK と 同じ ) 
T LIGHTBLUE Ox20 青 (T BLUE と 同じ ) 

T LIGHTGREEN Ox80 緑 (T GREEN と 同じ ) 
T LIGHTCYAN OxA0 水色 (T CYAN と 同じ ) 
T LIGHTRED 0x40 赤 (T RED と 同じ ) 

T LIGHTMAGENTA Ox60 柴 (T MAGENTA と 同じ ) 
T YELLOW OxCO 黄色 

T WHITE OxE0 自 

VERTICALLINE Ox10 縦 線 の 添付 
NOVERTICALLINE Ox00 

UNDERLINE 0x08 下線 の 添付 
NOUNDERLINE Ox00 

REVERSE Ox04 反転 表示 

NOREVERSE Ox00 

BLINK 0x02 点 減 表示 

NOBLINK Ox00 

SECRET Ox00 

NOSECRET Ox01 隠し 属性 の 否定 
BASICGRAPH Ox10 グラ フィ ッ ク 文 字 の 指示 
NOBASIOGRAPH Ox00 
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戻り 値 あり ませ ん 。 


可 搬 性 textattr は PC-9801 シ リー ズ で の みろ 動 作 し ます 。 
関連 項目 gettextinfo, normvideo, textcolor 
例 #1nclude <conto.h> 
main() 
6 
textmode(VL8025) /* 対象 の モー ド */ 


textattr(CYAN | REVERSE | NOSECRET): 
/* 水色 ・ 反 転属 性 */ 
7 ルー・ すき / 
textattr(CRED ! REVERSE | BLTNK | NOSECRET): 
/* 赤色 ・ 反 転 点 減 属性 */ 
ECOL// 
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textattr (IBM PC) 


機能 


形式 


プロ ト タ イ プ 


解説 


484 


テキ スト 属性 を セッ ト し ます 。 
Void textattr(int 7ewg7) ・ 
conio.h 


textattr は , 1 回 の 呼び 出し で フォ アグ ラウ ンド と バッ ク グ ラウ ンド の 両 

方 の 色 を セッ ト す る こと が で きま す (textattr を 使わ な い 場 合 に は 、 こ れ 
ら の 属性 は 、 それ ぞ れ textcolor お よび textbackground に よっ て セッ ト 
し ます )。 

この 関数 の 呼び 出し は , 以降 に 呼び 出さ れる 直接 コン ソー ルス 入 出力 関数 
(cprintf な ど ) が 出力 する 文字 に の み 影 響 を 与え ます 。 す で に 画面 に 表示 
され て いる 文字 , お よび printf な どの 標準 入出 力 ス トリ ー ム を 使用 する 関 

数 が 出力 する 文字 に は 影響 を 与え を ませ ん 。 

引数 zewg/ の 各 ビ ッ ト の 意味 (色情 報 ) は 次 の よう に な っ て いま す 。 


b7 _ b6 b5 b4 b3 b2 bl b0 


Llblblblil 


ffff この 4 ビッ ト で フォ アグ ラウ ンド 色 を 表わし ます (0-15)。 
bbb この 3 ビッ ト で バッ ク グ ラウ ンド 色 を 表わし ます (0-8)。 
B プリ ンク (点滅 ) 指定 ビッ ト で す 。 


プリ ンク 指定 ビッ ト が オン の と き に は , 文字 が 点 減 し ます 。 こ れ は , 履 性 
値 に 定数 BLINK を 加え る こと に よっ て 指定 する こと が で きま す 。 
zewgf/ に 指定 する 値 に は 、conio.h の 中 で 定義 8 れ て いる シン ポリ ッ ク 定 
数 を 使用 する こと が で きま す 。 バ ッ ク グ ラウ ンド 色 の 指定 に 関し て は 次 の 
よう な 制限 が ある こと に 注意 し て くだ さい 。 


較 バ パック グラ ウン ド 色 に は , 前 半 の 8 色 し か 選択 で きま せん 。 
圏 バ ッ ク グ ラウ ンド 色 は , 定数 値 を 左 に 4 ビッ トシ フト する こと に よっ て 
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正しい ビッ ト 位 置 が 得 ら れ ま す ( 例 を 参照 し て くだ さい )。 


定数 名 値 フォ ア / バ ッ ク 
BLACK 0 両方 
BLUE 1 両方 
GREEN 2 両方 
CYAN 3 両方 
RED 4 両方 
MAGENTA 5 両方 
BROWN 6 両方 
LIGHTGRAY 6 両方 
DARKGRAY 8 フォ アグ ラウ ンド の み 
LIGHTBLUE 9 フォ アグ ラウ ンド の み 
LIGHTGREEN 10 フォ アグ ラウ ンド の み 
LIGHTCYAN 11 フォ アグ ラウ ンド の み 
LIGHTRED 12 フォ アグ ラウ ンド の み 
LIGHTMAGENTA 13 フォ アグ ラウ ンド の み 
YELLOW 14 フォ アグ ラウ ンド の み 
WHITE 15 フォ アグ ラウ ンド の み 
BLINK 128 フォ アグ ラウ ンド の み 
戻り 値 あり ませ ん 。 
可 搬 性 textattr は IBM PC と その 互換 機 で の み 動 作 し ます 。 
関連 項目 gettextinfo, highvideo, lowvideo, normyideo, textbackground, 
textcolor 
例 /* バッ ク グ ラウ ンド に 青 。 文字 に 点 減 の 催 色 を 選択 する */ 


textattr(YELLOW + (BLUE<<4 ) + BLTNK): 


cputs( "He11o。 wor1d*): 
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textbackground 


機能 文字 の バッ ク グ ラウ ンド 色 を セッ ト し ます 。 


形式 void textbackground(int zewco/oy) ・ 


プロ ト タ イ プ conioh 


解説 PC-9801 シ リー ズ で は , textbackground は 何 の 動作 も し な い ダ ミー 関数 
で す 。 


IBM PC で は , textbackground は バッ ク グ ラウ ンド テキ スト 色 を 選択 し 
ます 。 

この 関数 の 呼び 出し 以降 に , 直接 ビデ オ 出 力 を 行なう テキ スト モー ド 関 数 
に よっ て 書か れる すべ て の 文字 の バッ ク グ ラウ ンド は , zewco/or で 与え ら 
れ た 色 に な り ま す 。 zewco/or に 指定 する の は 0 一 7 の 整数 で す 。 
textbackground を 呼び 出し た 時 点 で 表示 され て いる 文字 に は 影響 を 与え 
ませ ん 。 

zewco/or に 指定 で きる 色 (シン ポリ ッ ク 定 数 また は 数 値 ) は 次 の 通り で 
す 。 


定数 名 値 


BLACK 0 
BLUE 1 
GREEN 2 
CYAN 3 
RED 4 
MAGENTA 5 
BROWN 6 
LIGHTGRAY 7 
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戻り 値 あり ませ ん 。 


可 搬性 textbackground は , PC-9801 シ リー ズ で は IBM PC と の 互換 性 の た め に 
エン トリ の み が 用 意 さ れ て いま す 。 
IBM PC で は , textbackground は IBM PC ある い は その 互換 機 で の み 動 
作 し ます 。 こ れ に 対応 する 関数 は Turbo Pascal 4.0 に も あり ます 。 


関連 項目 gettextinfo, textattr, textcolor 
例 /* バッ ク グ ラウ ンド を 系 に する */ 
textbackground(MAGENTA) : 
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textbank (PC-9801 の み ) 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


例 


488 


画面 ペー ジ を 切り 換え ます 。 


void textbank(int の gz ん ) ・ 


conio.h 


textbank は , 画面 ペー ジ の 切り 換え を 行ない ます 。 引 数 zzk に は 0 また は 
1 を 指定 し て くだ さい 。 

2 つの 画面 ペー ジ に は それ ぞ れ 別々 に , ウィ ンド ウ , 文字 属性 ,。 カーソル 位 
置 の 属性 を セッ ト す る こと が で きま す 。 た だ し ,、 テキ スト モー ド は 同じ も 
の に な り ま す 。 


注意 : PC-9801 の 最初 期 型 。 お よび PC-9801U02 に は 画面 ペー ジ は 1 枚 し か な 
い ( テ キス ト VRAM が 1 画面 分 し か な い ) の で , ペー ジ 1 を 使用 する こと は 
で きま せん 。 


あり ませ ん 。 


textbank は 、PC-9801 で の みろ 動作 し ます 。 


textmode 


す #1nc1ude <conio.h> 

vold main() 

{ 
textbank(1) : /* バン ク 切 り 換え */ 
textco1or(BLDUE) : 
cprintE(" ペ ー ジ 1 を 表示 し まし た 。\c\n"): 
textbank(0): /* バン ク 切 り 換え */ 
textco1or(GREEN) : 
cprintE(" ペ ー ジ 0 を 表示 し まし た 。\cn"): 
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ニー ニー ーー ニニ ーー ニュー ニー ニーー。 ーー ニー ニー。 
textbliink (PC-9801 の み ) 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


例 


文字 の 点 減 属 性 を セッ ト し ます 。 


void textblink (int が 訪 ん ) : 


conio.h 


textblink は , 文字 の 点滅 属性 を セッ ント し ます 。 引数 yk に は , conio.h さ 

れ て いる シン ポリ ッ ク 定 数 BLINK (0x02) また は NOBLINK (0x00) 指定 
し ます 。 

この 関数 の 呼び 出し は , 以降 に 呼び 出 きれ る 直接 コン ソー ル 入 出力 関数 
(cprintf な ど ) の 文字 に 影響 を 与え ます 。 


あり ませ ん 。 


textblimk は 、 PC-9801 シ リー ズ で の み 動 作 し ます 。 


textattr 


#1nc1ude <conio.h> 


Yold main() 

( 
textb11nk(BLTNK) : /* 点滅 を 設定 */ 
cprintf(* 点 減 表示 \r\n'): 
textb11nk(NOBLTNK ) : /* 点 減 を 解除 */ 


} 
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textcolor (PC-9801) 


機能 


形式 


プロ ト タ イ プ 


解説 


490 


文字 の 色 属 性 を セッ ト し ます 。 


#include <conio.h> 


void textcolor(int zewco/oy) : 


conio.h 


textcolor は , 文字 の 色 属 性 を セッ ト し ます 。 

この 関数 の 呼び 出し は , 以降 に 呼び 出さ れる 直接 コン ソー ル 入 出力 関数 
(cprintf な ど ) が 出力 する 文字 に の み 影響 を 与え ます 。 す で に 画面 に 表示 
され て いる 文字 , お よび printf な どの 標準 入出 力 ス トリ ー ム を 使用 する 関 

数 が 出力 する 文字 に は 影響 を 与え ませ ん 。 

ヵ ewco/or に は ,conio.h に 定義 きれ て いる 以下 の シン ポリ ッ ク 定 数 (ある い 

は その 値 ) を 指定 し ます 。 


定数 名 値 意味 

T_BLACK Ox00 時 

T_BLUE 0x20 育 

T_ GREEN 0x80 緑 

T_CYAN 0xA0 水色 

T_RED Ox40 赤 

T_MAGENTA Ox60 紫 

T_BROWN OxCO 次 色 (T YELLOW と 同じ ) 
T LIGHTGRAY OxEO 白 (T WHITE と 同じ ) 
T_DARKGRAY 0x00 黒 (T BLACK と 同じ ) 
T LIGHTBLUE Ox20 青 (T BLUE と 同じ ) 

T LIGHTGREEN Ox80 緑 (T GREEN と 同じ ) 
T LIGHTCYAN OxA0 水色 (T CYAN と 同じ ) 
T LIGHTRED Ox40 赤 (T_RED と 同じ ) 
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T LIGHTMAGENTA Ox60 紫 (T MAGENTA と 同じ ) 


T_YELLOW OxCO 黄色 
T_ WHITE OxE0 白 
戻り 値 あり ませ ん 。 
可 搬性 textcolor は PC-9801 シ リー ズ で の みろ 動作 し ます 。 こ れ に 対応 する 関数 が 


Turbo Pascal に も あり ます 。 


関連 項目 gettextinfo, normvideo, textattr, textbackground 
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textcolor (IBM PC) 


機能 テキ スト モー ド で の 文字 色 を 選択 し ます 。 


形式 #include <conio.h> 
void textcolor(int zewco/o) : 


プロ ト タ イ プ conioh 


解説 texteolor は 、 フ ォ ア グラ ウン ド の 文字 色 を 選択 し ます 。 以降 に コン ソー ル 
出力 関数 に よっ て 書か れる すべ て の 文字 の フォ アグ ラウ ンド 色 は , zew- 
co/or に 与 た られ た 色 に な り ま す 。zewco/or に は , conio.h で 定義 きれ て い 
る シン ポリ ッ ク 定 数 を 使用 する こと が で きま す 。 シ ン ポ リッ ク 定 数 を 使う 
場合 に は , conio.h を イン クル ー ド し な けれ ば な り ま せん 。 
この 関数 の 呼び 出し は , 以降 に 呼び 出さ れる 直接 コン ソー ル 入 出力 関数 

(cprintf な ど ) が 表示 する 文字 に の み 影 響 を 与え ます 。textcolor が 呼び 

出さ れ た で 表示 され て いる 文字 に は 影響 を 与え を ませ ん 。 ま た , printf 
な どの 標準 入出 力 ス トリ ー ム を 使用 する 関数 に は 影響 し ませ ん 。 
次 に 示し た の は , フォ アグ ラウ ンド に 使用 で きる 色 (シン ポリ ッ ク 定 数 ) 


お よび その 値 で す 。 

定数 名 値 定数 名 値 

BLACK 0 DARKGRAY 

BLUE 51 LIGHTBLUE 

GREEN 2 LIGHTGREEN 10 

CYAN 3 LIGHTCYAN 11 

RED 4 LIGHTRED 12 

MAGENTA 5 LIGHTMAGENTA 13 

BROWN 6 YELLOW 14 

LIGHTGRAY 7 WHITE 15 
BLINK 128 
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戻り 値 


可 搬性 


関連 項目 


文字 を プリ ンク (点滅 ) させ た いと き に は , フォ アグ ラウ ンド 色 に 128 を 加 
そま す 。 これ に は 定義 済み の 定数 BLINK を 使う こと が で きま す 。 た と え 
ば 次 の よう に し ます 。 


textcolor(CYAN + BLTNK): 


注意 : モニ タ の 種類 に よっ て は 、8 つ の 明る い 色 (8 一 15) を 作る た め に 用 
いら れる 高 度 信号 が 認識 され な いこ と が あり ます 。 こ の よう な モニ タ で 
は , 明る い 色 は 暗い 色 (0-7) と まっ た く 同 じ 色 に な り ま す 。 ま た , シス 
テム に よっ て は これ ら の 数 値 を 色 の 違い で は な く , 単色 の 階 調 、 特殊 な パ 
ター ン 、 ある い は 特別 な 属性 (下線 、 ポ ボー ルド ,、 イタリック , な ど ) で 表 
現す る も の も あり ます 。 こ うし た シス テム で , 色 の 指定 が 実際 に 画面 に ど 
の よう に 表示 され る か は ハー ドウ ェ ア に 依存 し ます 。 


あり ませ ん 。 


textcolor は IBM PC お よび その 互換 機 で の み 動作 し ます 。 これ に 対応 す 
る 関数 が Turbo Pascal に も あり ます 。 


gettextinfo, highvideo, lowvideo, normvideo, textattr, 
textbackground 
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textcursor (PC-9801 の み ) 


機能 カー ソル の 属性 を 設定 し ます 。 


形式 void textcursor(int cgrsor) ・ 


プロ ト タ イ プ conioh 


解脱 texteursor は 、 カ ー ソ ル 属 性 を 設定 し ます 。 カ ー ソ ル の 表示 また は 非 表 示 
の 指定 、 カー ソル の 静止 表示 また は 点滅 表示 の 指定 を 行ない ます 。 
引数 erspr に は , ヘッ ダフ ァイル conio.h で 定義 さき され て いる シン ポリ ッ ク 
定数 を 指定 する こと が で きま す 。 


定数 名 値 意味 
DISP CURSOR 0x01 カー ソル 表示 
NODISP CURSOR Ox00 カー ソル 非 表示 
BLINK CURSOR Ox00 カー ソル 点 減 表示 
NOBLINK CURSOR 0x02 カー ソル 静止 表示 
戻り 値 あり ませ ん 。 
可 搬 性 PC-9801 シ リー ズ で の みろ 動作 し ます 。 
例 1nclude <conio.h> 


Yold maln() 
{ 
textcursor(DTSP_CURSOR ! BLTNK CURSOR): 
/* カー ソル 点滅 表 示 */ 
textcursor(DISP_CURSOR | NOBLITNK_CURSOR) : 
/* カー ソル 静止 表示 */ 
textcursor(NODTSP_CURSOR ) /* カー ソル 非 表示  */ 
/* ォ / 
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textmode (PC-9801) 


機能 


形式 


プ ブ プロトタイプ 


テキ スト モー ド を 設定 し ます 。 


void textmode(int zewzzode) ・ 


conio.h 


textmode は , 引数 zewyzoge で 指定 され た テキ スト モー ド を 設定 し ます 。 
目的 と する テキ スト モー ド は , conio.h に 定義 され て いる 列挙 型 ex/ 
odesy の 中 の シン ポリ ッ ク 定 数 に よっ て 指定 する こと が で きま す 。 シ ン ポ 
リッ ク 定 数 を 使用 する 場合 に は , conio.h を イン クル ー ド し な けれ ば な り 
ませ ん 。 
テキ スト モー ド は ペー ジ ご と に 異な る モー ド を 設定 する こと は で きま せん 
(textbank を 参照 )、 ま た , この 関数 で 設定 を 行なわ ず に 表示 関数 を 使用 
し た と き 。, 桁 数 と 行 数 , 縦 算 線 の 有無 、 お よび 文字 の 色 属 性 は 、 プロ グラ 
ム を 起動 し た と き に 設定 され て いた 状態 と 同じ も の に な り ま す 。 
7ex7 7 の des 型 の 定数 、 数 値 。 お よび 設定 され る モー ド は 以下 の 通り です 。 


定数 名 値 テキ スト モー ド 
LASTMODE 直前 に 設定 し た テキ スト モー ド 
VL8025 80 桁 X25 行 , 縦 時 線 が 有効 


1 

0 
VL8020 1 80 桁 X20 行 縦 時 線 が 有効 
VL4025 2 40 桁 X25 行 , 縦 鐵 線 が 有効 
VL4020 3 40 桁 X20 行 , 疑 時 線 が 有効 
BG8025 4 80 桁 X25 行 , グラ フィ ッ ク 文 字 が 有効 
BG8020 5 80 桁 X20 行 , グラ フィ ッ ク 文 字 が 有効 
BG4025 6 40 桁 25 行 , グラ フィ ッ ク 文 字 が 有効 
BG4020 7 40 桁 X20 行 , グラ フィ ッ ク 文 字 が 有効 
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戻り 値 


可 搬性 


関連 項目 


496 


VLxxxx を 設定 し た と き に 画面 に 表示 され る 文字 イメ ー ジ は 次 の よう に 
なり ます 


VL ANK コー ド シフ ト JIS コー ド 


VL ォ フ 半角 文字 全角 文字 
VL オン 縦 粘 線 つ き 半 角 文 字 縦 界 線 つ き 全角 文字 


注意 : V し オン と は , textvertical に よっ て 縦 申 線 の 表示 が 有効 に を っ て 
いる こと を いい ます 。 


BGxxxx を 設定 し た と き に 画面 に 表示 され る 文字 イメ ー ジ は 次 の よう に 
な り ま す 。 


BG ANK コー ド シフ ト JIS コー ド 


VL オ ォ オフ 半角 文字 グラ フィ ッ ク 文 字 (半角 ) 
VL ォ ン 簡易 グラ フィ ッ ク バ ター ン 簡易 グラ フィ ッ ク バ ター ン 


注意 : BGxxxx の 場合 は 、 シ フト JIS コー ド か ら JIS コー ド へ の 変換 は 行 
な いま せん 。 


textmode が 呼び 出さ れる と , カレ ント ウィ ンド ウ は 画面 全体 に リセ ッ ト 
され , カレ ント テキ スト 属性 は ノー マル に リセ ッ ト さ れ ま す 。 ノ ー マ ル 属 
性 は mormvideo に よっ て 設定 され る 属性 に 対応 し ます 。 


あり ませ ん 。 


textmode は PC-9801 で の みろ 動作 し ます 。 対 応 す る 関数 が Turbo Pascal に 
も あり ます 。 


gettextinfo、 window 
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textmode (IBM PC) 


機能 テキ スト モー ド を 設定 し ます 。 
形式 void textmode(int zewzzode) : 


プロ ト タ イ プ conio.h 


解説 textmode は 、 指定 され た テキ スト モー ド を 選択 し ます 。 
目的 と する テキ スト モー ド ( 引 数 zewyode) は 。 conio.h に 定義 され て いる 
列挙 型 zex7 odesy の 中 の シン ポリ ッ ク 定 数 に よっ て 与え ます 。 こ れ ら の 
定数 を 使用 する 場合 に は , conio.h を イン クル ー ド し な けれ ば な り ま せん 。 
ex _7zoges 型 の 定数 , 数 値 。 お よび 設定 され る モー ド は 以下 の 通り で す 。 


定数 名 値 テキ スト モー ド 

LASTMODE  -1 直前 に 設定 し た テキ スト モー ド 
BW40 0 白黒, 40 桁 

C40 1 カラー, 40 桁 

BW80 2 白黒 80 祐 

C80 3 カラー, 80 桁 

MONO 7 。 モノクロ, 80 桁 


textmode が 呼び 出さ れる と , カレ ント ウィ ンド ウ は 画面 全体 に リセ ッ ト 
さき され, カレ ント テキ スト 属性 は ノー マル に リセ ッ ト さ れ ま す 。 ノー マル 属 
性 は mormyideo に よっ て 設定 され る 属性 に 対応 し ます 。 

LASTMODE を 指定 し て textmode を 呼び 出す と , 前 回 選択 され た テキ ス 
トモ ー ド に 再び 設定 され ます 。 こ の 機能 は 、 グラ フィ ックス モー ド を 使用 
し た 後 で チキ スト モー ド に 戻る よう な 場合 に の み 有 用 と な り ま す 。 
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戻り 値 


可 搬 性 


関連 項目 


498 


textmode は , 画面 が ゲ デ テキ スト モー ド で ある (つま り 現 在 の テキ スト モー ド 
を 別 の モー ド に 変更 する ) 場合 に の み 使用 きれ る べき で す 。 画 面 が グラ フ 
ィ ッ クス モー ド で ある 場合 に は , restorecrtmode に よっ て テキ スト モー 
ド に 戻っ て か ら , textmode を 呼び 出す よう に し て くだ さい 。 


あり ませ ん 。 


textmode は , IBM PC お よび その 互換 機 で の み 動作 し ます 。 これ に 対応 す 
る 関数 が Turbo Pascal に も あり ます 。 


gettextinfo、window 
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textreverse (PC-9801 の み ) 


機能 


形式 


プロ ト タ イ プ 


解脱 


文字 の 反転 属性 を セッ ト し ます 。 


#include <conio.h> 


void textreverse(int 7eyerse) ・ 


conio.h 


textreverse は 。 文字 の 反転 属性 を セッ ト し ます 。 引数 7everse に は , conio. 

h に 定義 きれ て いる シン ポリ ッ ク 定 数 REVERSE (0x04) また は NOR- 

EVERSE (0x00) を 指定 し ます 。 

この 関数 の 呼び 出し は , 以降 に 呼び 出さ れる 直接 コン ソー ル 入 出力 関 数 
(cprintf な ど ) が 出力 する 文字 に の み 影 響 を 与え ます 。 す で に 画面 に 表示 

きれ て いる 文字 , お よび printf な どの 標準 入出 力 ス トリ ー ム を 使用 する 関 

数 が 出力 する 文字 に は 影響 を 与え を ませ ん 。 


あり ませ ん 。 
PC-9801 シ リー ズ で の み 動 作 し ます 。 
textattr 


ず #include <conio.h> 
void main() 
{ 


textreverse(REVERSE): /* 反転 を 設定 */ 
cpPrintf(" 反 転 表示 \r\n*): 
textreverse(NOREVERSE) : /* 反転 を 解除 メ / 


} 
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textunder (PC-9801 の み ) 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 


例 


500 


文字 の 下線 属性 を セッ ト し ます 。 


#include <conio.h> 


void textunder(int zzdey) ・ 


conio.h 


textunder は , 文字 の 下線 属性 を セッ ト し ます 。 引数 der に は , conioh 

に 定義 8 れ て いる シン ポリ ッ ク 定 数 UNDERLINE (0x08) また は NOUN- 

DERLINE (Ox00) を 指定 し ます 。 

この 関数 の 呼び 出し は , 以降 に 呼び 出さ れる 直接 コン ソー ル 入 出力 関数 
(cprintf な ど ) が 出力 する 文字 に の み 影 響 を 与え を ます 。 す で に 画面 に 表示 

され て いる 文字 , お よび printf な どの 標準 入出 力 ス トリ ー ム を 使用 する 関 

数 が 出力 する 文字 に は 影響 を 与え ませ ん 。 


あり ませ ん 。 


PC-9801 シ リー ズ て の み 動 作 し ます 。 


textattr 


#include <conio.h> 
void main() 
9 


textunder(UNDERLTNE /* 下線 を 設定 */ 
cprintf(" 下 線 表示 \r\n 
textunder(NOUNDERLTNE) : /* 下線 を 解除 メ / 


} 
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textvertical (PC-9801 の み ) 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 


例 


文字 の 縦 線 属性 を セッ ト し ます 。 


#include <conio.h> 


void textvertical(int ve/icg7) : 


conio.h 


textvertical は , 文字 の 縦 線 属性 を セッ ト し ます 。 引 数 vercg7 に は , conio. 

h て 定義 きれ て いる VERTICAL (Ox10) また は NOVERTICAL (0x00) 

を 指定 し ます 。 

この 関数 の 呼び 出し は , 以降 に 呼び 出さ れる 直接 コン ソー ル 入 出力 関数 
(cprintf な ど ) が 出力 する 文字 に の み 影 響 を 与え を ます 。 すでに 画面 に 表示 

され て いる 文字 . お よび printf な どの 標準 入出 力 スト リー ム を 使用 する 関 

数 が 出力 する 文字 に は 影響 を 与え を ませ ん 。 

textvertical は 、 テ キス トモ ー ド が BGxxxx の 場合 に は ,、 グ ラフ イッ ク 文 

字 の 表示 切り 換え の 意味 に な り ま す 。 


あり ませ ん 。 
PC-9801 シ リー ズ で の み 動 作 し ます 。 
textattr、 textmode 


ま include <conio.h> 
Yoid main() 
{ 


textvertica1(VERTTCALLTNE) : /* 縦 線 を 設定 */ 
cPrintf(" 縦 線 表示 \r\n* ): 
textverttca1(NOVERTTCALLTNE) /* 縦 線 を 解除 */ 


} 
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wherex 


機能 ウィ ンド ウ 内 で の 水平 方 向 の カー ソル 位置 を 得 ます 。 


形式 int wherex (void) : 


プロ ト タ イ プ conioh 


解説 wherex は , カレ ント テキ スト ウィ ンド ウ 内 で の カー ソル 位置 の x 座 標 を 
返し ます 。 

戻り 値 wherex は 、 1 一 80 の 幼 囲 の 整数 値 を 返し ます 。 

可 搬性 wherex は , PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 


し ます 。 こ れ に 対応 する 関数 は Turbo Pascal に も あり ます 。 


関連 項目 gettextinfo, gotoxy, wherey 


例 Printf(" The cursor 1s at (Zd,Zd)\n" 。 wherex(), wherey( ) )』 
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wherey 


機能 ウィ ンド ウ 内 で の 垂直 方 向 の カー ソル 位置 を 得 ます 。 


形式 int wherey( void ) : 


プロ ト タ イ プ conio.h 


解説 wherey は 、 カ レン ト テ キス トウ ィ ン ド ウ 内 で の カー ソル 位置 の y 座 標 を 
返し ます 。 

戻り 値 wherey は 、1 一 25 の 範囲 の 整数 値 返 し ます 。 

可 搬 性 wherey は , PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の みろ 動作 


し ます 。 こ れ に 対応 する 関数 は Turbo Pascal に も あり ます 。 


関連 項目 gettextinfo, gotoxy, wherex 


例 wherex を 参照 し て くだ さい 。 
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window 


機能 アク ティ プ テ キ スト ウィ ンド ウ を 定義 し ます 。 
形式 void window (int /e77, int 7op, int 7jg77, int の oro7z) 
プロ ト タ イ プ conioh 


解説 window は , 画面 上 に テキ スト ウィ ンド ウ を 定義 し ます 。 座 標 が 有効 で な い 
場合 は 、 window の 呼び 出し は 無視 され ます 。 
77 と 7 の の は ウィ ンド ウ の 左上 隅 画 面 上 の 座標 で す 。 
7g が 7 と 2o77o77 は 右 下 隅 の 画面 上 の 座標 で す 。 
テキ スト ウィ ンド ウ の 最小 の 大 きき は, 1 行 1 桁 で す 。 デ フォ ルト ウィ ンド 
ウ は 画面 全体 で あり , 次 の よう な 座標 を 持っ て いま す 。 


田 PC-9801 : 
80 桁 25 行 モー ド (1,1) 一 (80,25) 
80 桁 20 行 モー ド (1.1) 一 (80.20) 
40 桁 25 行 モー ド (1.1) 一 (40.25) 
40 桁 20 行 モー ド (1.1) 一 (40.20) 


画 IBM PC: 
80 桁 モード (1.1) 一 (80.25) 
40 桁 モー ド (1.1) 一 (40,25) 


戻り 値 あり ませ ん 。 


可 搬性 window は , PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます 。 こ れ に 対応 する 関数 は Turbo Pascal に も あり ます 。 


関連 項目 clreol, clrscr, delline, gettextinfo, gotoxy, insline, 
puttext, textmode 
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aTC 


形式 


プロ ト タ イ プ 


戻り 値 


円 刀 を 描き ます 。 


#include <graphics.h> 


void far arc(int *、int 了 , int sgzge。 int ezggzge、 int /ggs) : 


graphics.h 


arc は , 円 弧 を カレ ント ドロ ウ カ ラー で 描き ます 。 

are は 、 中 心 が (、 了 ), 半径 7ggis の 円 弧 を 描き ます 。 円弧 は srgzge か 
ら ezdg2g/e ま で で す 。 srgzge 三 0 か つ edgnge 王 360 の 場合 は 、 arc の 呼び 
出し は 完全 な 円 を 描き ます 。 

arc の 角度 は , 反 時 計 ま わり で , 0 度 が 3 時 の 方 向 , 90 度 が 12 時 の 方 向 で す 。 


注意 : カレ ント ライ ンス タイ ル は 円弧 に は 影響 を 与え を ませ ん が ,。 ライ ン 
幅 は 円 弧 に 影響 し ます 。 


注意 [IBM PC] : CGA の ハイ レゾ リュ ーション モー ド , ある い は モノ クロ 
グラ フィ ックス アダ プ タ を 使用 し て いる 場合 、 こ の マニ ュ ア ル に ある サン 
プル プロ グラ ム は 期待 通り に 動か な いこ と が あり ます 。CGA の ハイ レゾ リ 
ユー ショ ン モ ー ド また は モノ クロ アダ プ タ を 使っ て いる 場合 は 、 フィ ルカ 
ラー ある い は ドロ ウ カ ラー を セッ ト す る 関数 (setcolor, setfillstyle, set- 
linestyle な ど ) に は, シン ポリ ッ ク 定 数 を 使わ ず に , 値 1 を 渡す よう に し て 
くだ さい 。 こ の 後 の 例 2 で , CGA ある い は モノ クロ アダ プ タ 上 で , arc, 
circle、ellipse, getarccoords、 getaspectratio、 お よび pieslice を どの よ 
うに 使う か を 示し て いま す 。 


あり ませ ん 。 
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可 搬 性 


関連 項目 


506 


arc は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 し ま 
す (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アダ プ タ を 
備え て いな けれ ば な り ま せん )。 


circle、 ellipse、 fillellipse、 getarccordes, pieslice、 sector 


nc1ude <graphtcs.h> 
す 1nclude <conio.h> 


main() 
{ 
int graphdriver = DETECT。 graphmodei  /* 自動 換 出 の 要求 */ 
Struct arccoordstyPe arcinfoi 
1nt xasp,。 yaSDi 
1ong xlongi 


1nitgraph(&graphdriver, &graphmode, ""):  /* 初期 化 */ 


/* 中 心 角 90 度 で 半径 50 の 円 紀 */ 
arc(150。 150。 0, 89, 50)』 


/* 円 弧 の 座標 を 得 て , 弦 を 結ぶ */ 

getarccoords(&arcinfo): 

11ne(arcinfo.xstart。 arcinfo、ystart。 
arcinfo.xend。 arcinfo.yend) : 


/* 円 を 描く */ 
ctrc1e(150, 150, 100): 


/* 円 の 中 に 権 円 を 描く */ 
e11ipse(150, 150, 0, 359, 100, 50): 


/* 扇 型 を 描い て フィ ル す る */ 

setcolor(WHTTE) : /* 輪郭 は 白 メ / 
setf111ety1e(SOLTD_FTLL, LTGHTRED) : 
pes11ce(100, 100, 0, 135,。 49): 
setf111ety1e(SOLTD_FTLL, LTGHTBLUE) : 
pies1ice(100, 100。 135, 225。 49) 
setf111sty1e(SOLTD_PTLL。 WHTTE) : 

pies1ice(100, 100, 225, 360,。 49)』 


/* 長方形 を 描く */ 

getaspectratio(&xasp,。 &yasp)i 

x1ong = (100L * (1ong)yasp) / (1ong)xaspi 
rectang1e(0, 0, (int)x1ong, 100): 
getch(): 

c1osegraph( ): 
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例 2 1nc1ude <graphtcs.h> 
まお 1nclude <conio.h> 


main() 
6 
int graphdriver = DETECT。 graphmode: 
Struct arccoordstype arcinfoi 
1nt 。 xasp。 yasps 
1ong 。x1ongi 


initgraph(&graphdriver。 &graphmode , ): 
/* 中 心 角 90 度 で 半径 50 の 円 弧 */ 
arc( 100, 120, 0, 89,。 50 ): 


/* 円 用 の 座標 を 得 て , 弦 を 結ぶ */ 

8etarccoords( &arcinfo ): 

11ne(arcinfo.xstart。 arcinfo.ystart,。 
arcinfo.xend。 arcinfo.yend) : 


/* 円 を 描く */ 
circ1e(100, 120, 80)』 


/* 円 の 中 に 椿 円 を 描く */ 
e111pse(100, 120, 0, 359。 80, 20): 


/* 刻 型 を 描い て フィ ル す る +/ 
setf111sty1e(HAYCH_PTLL。 1)。 
pies1ice(200。 50, 0, 134。 49): 
setE111sty1e(SLASH_PTLL。 1) 
pies1ice(200, 50。 135。 225。 49): 
setf111sty1e(WTDE_ DOT FILL, 1) 
pies1ice(200。 50。 225。 360, 49): 


/* 長方形 を 描く */ 

getaspectratio(&xasp,。 &yasP)i 

x1ong = (50L * (1ong) yasp) / (1ong) xaspi 
rectang1e(0, 0, (Int)x1ong, 50) 

getch( ) 

c1osegraph(): 
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/* 自動 検出 の 要求 */ 


/* 初期 化 */ 


50Z 


bar 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬性 


関連 項目 


508 


二 次 元 バ ー (長方形 ) を 描き ます 。 


#include <graphics.h> 
void far bar(int /g77。 int op, int 77g 太 、 int 2o7/o7) : 


graphics.h 


#include <conio.h> 


bar は 、 フィ ル さ れ た 二 次 元 バ ー (長方形 ) を 描き ます 。 バ ー は , カレ ント 
フィ ル パ タ ー ン と フィ ルカ ラー を 使っ て フィ ル さ れ ま す 。bar は 長方形 の 
輪郭 は 描き ませ ん 。 輪郭 の ある 2 次 元 の バー を 描く に は , dep を 0 に し て 
bar3d を 用 いて くだ さい 。 

長方形 の 左上 と 右 下 は , (7 op) と (7g が 7。 2o7o) で 与え ます 。 こ れ 
ら の 座標 は 。 ピク セル を 参照 し ます 。 


あり ませ ん 。 


bar は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 し ま 
す (BM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ プ タ を 
備 た て いな けれ ば な り ま せん )。 


bar3d, rectangle、setcolor、setfillstyle 


nc1ude <graphtcs.h> 


main() 
6 
1nt graphdriver = DETECT, graphmode:  /* 自動 検出 を 要求 */ 


1nttgraph(&graphdriver。 &graphmode,。*"):  /* 初期 化 */ 
setf111style(SOLTID FILL。 MAGCENTA) : 

bar3d(100, 10, 200,。100, 5, 1)。 
setE111style(HATCH_FTLL。 RED): 

bar(30, 30, 80, 80。): 


getche( ) : 
c1osegraph( ) : 


第 2 章 Turbo C ラ イブ ラリ 


Dar3d 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬 性 


3 次 元 バ ー を 描き ます 。 


#include <graphics.h> 
void far bar3d(int /g/7、 int 7op、 int gr。 int 2o//o77。 
int の ep/7。 int 7op772g) : 


graphics.h 


bar3d は , 3 次 元 の バー を 描き , カレ ント フィ ル バ パタ ー ン と フィ ルカ ラー で 
中 を フィ ル し ます 。 パー の 3 次 元 の 輪郭 は 、 カ レン トラ イン スタ イル と カラ 
ー で 描き ます 。 バ パー の 奥行 き は , ビク セル 数 で , ep に よっ て 与え ます 。 
7 の の 7gg は 、 バ パー に 3D トッ プ を つけ る か どう か を 指定 する た め に 使い ます 。 
7 の の 7gg が 0 で な けれ ば ,、 トッ プ が つけ られ ます 。 そ う で な けれ ば , (バー を 
積み 重ね る こと を 可能 と する た め に ) バー に トッ プ を つけ ませ ん 。bar3d 
は , 長方形 の 左上 と 右 下 を , (/g77、 7op) と (7g7/。 2oo) で 与え ます 。 
bar3d の 典型 的 な 奥行 き は , 次 の よう に バー の 幅 の 25% を と れ ば よい で し 
ょ う 。 


bar3d(1eft, top, right, bottom。 (right - reft)/4,。1)』 

あり ませ ん 。 

bar3d は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 し 
ます (BM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ プ タ 
を 備え て いな けれ ば な り ま せん )。 


bar, rectangle, setcolor、 setfillstyle, setlinestyle 


bar を 参照 し て くだ さい 。 
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circle 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 
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与え られ た 半径 で 指定 の 点 を 中 心 に 円 を 描き ます 。 


#include <graphics.h> 


Void far circle(int x。int 了 。 int 7gdizs) : 
graphics.h 


circle は , カレ ント ドロ ウ カ ラー で , 中 心 (x) に , 半径 7gggws の 円 を 描 
きま す 。 


注意 : カレ ント ライ ンス タイ ル は 。 円 周 に は 影響 を 与え を ませ ん 。 た だ し ラ 
イン 幅 は 円 周 に 影響 し ます 。 


各 グ ラフ ィ ッ クス ドラ イ バ と グラ フィ ックス モー ド に は , ア スペ クト 比 ( ビ 
クセ ル の 縦 横 比 ) が 含ま れ て いま す 。 circle は , 画面 に 弧 を 描く 際 の スケ ー 
リン グ と し て この アス ペク ト 比 を 使い ます 。 使 用 し て いる ディ スプ レイ で 
円 が 真 円 と し て 描か れ な い 場 合 に は 、 setaspectratio に よっ て , アス ペク 
ト 比 を 調整 する こと が で きま す 。 


あり ませ ん 。 
circle は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 し 
ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アダ プ タ 


を 備え を て いな けれ ば な り ま せん )。 


arc, ellipse, fillellipse, getaspectratio, pieslice, sector, 
setaspectratio 


arc を 参照 し て くだ さい 。 
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cleardevice 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


グラ フィ ックス 画面 を クリ ア し ます 。 


#include <graphics.h> 
Yoid far cleardevice(void) ・ 


graphics.h 

cleardevice は , グラ フィ ックス 画面 全体 を クリ ア し (つま り カ レン トバ パッ 
ク グ ラウ ンド カラ ー で フィ ル し ます ), CP( カ レン ト ポジ ショ ン ) を ホー ム 
ポジ ショ ン (0.0) に 移し ます 。 

あり ませ ん 。 

cleardevice は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 
動作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ ア 


ダ プ タ を 備え て いな けれ ば な り ま せん )。 


clearviewport 
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clearviewport 


機能 


形式 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬 性 


関連 項目 


例 


512 


カレ ント ビ ピュー ポー ト を クリ ア し ます 。 


#include <graphics.h> 


void far clearviewport(void) : 


graphics.h 


clearviewport は 、 ビ ュー ポー ト を クリ ア し , CP (カレ ント ポジション) 
を ビュ ー ポ ー ト 相対 の ホー ム ポ ジ シ ョ ン (0.0) に 移し ます 。 


あり ませ ん 。 


clearviewport は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
み 動 作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ 
アダ プ タ を 備え て いな けれ ば な り ま せん )。 


cleardevice、getyiewsettings, setviewport 


nc1ude <graphics.h> 


matn() 
{ 
1nt graphdriver = DETECT, graphmode: /* 自動 検出 を 要求 */ 


setviewport(30, 30。 130, 130, 0): 

outtextxy(10。 10。 "Het any key to clear viewport ..…"): 
getch(): /* キー 入力 持ち */ 

c1earviewport(): /* キー 入力 が あっ た ら ビ ュー ポ ボート を クリ ア */ 
c1osegraph(): 
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closegraph 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


グラ フィ ックス シス テム の 使用 を 終了 し ます 。 


#include <graphics.h> 
void far closegraph (void) : 


graphics.h 

closegraph は 、 グラ フィ ックス シス テム に よっ て 割り 当て られ た メモ リ を 
解放 し 、 initgraph を 呼び 出す 前 の モー ド に 画面 を 戻し ます (グラ フィ ッ ク 
スシ ステ ム は , graphfreemem を 呼び 出し て 、 ド ライ バ , フォ ント , 内 部 
バッ ファ な ど に 使用 し て いた メモ リ を 解放 し ます )。 

あり ませ ん 。 

closegraph は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アダ 


プ タ を 備え て いな けれ ば な り ま せん)。 


initgraph, setgraphbufsize 
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detectgraph 


機能 ハー ドウ ェ ア を チェ ッ ク し て , 使用 すべ き グ ラフ ィ ッ クス ドラ イ バ と モー 
ド を 決定 し ます 。 
形式 #include <graphics.h> 


void far detectgraph(int far * grgpgdrzyer。 int far * g7GZ70ge) : 
プロ ト タ イ プ graphics.h 


解説 detectgraph は 、 使用 し て いる シス テム に 装備 され て いる グラ フィ ックス 
ハー ドウ ェ ア を 検出 し , 最高 の 品質 が 得 ら れる グラ フィ ックス ドラ イ バ と 
モー ド を 決定 し ます 。 
PC-9801 で は , GRCG ある い は EGC が 備え と られ て いる か どう か を 調べ , 最 
も 高速 な 出力 、 お よび 4096 色 中 16 色 が 使用 可能 か (あるいは 8 色 の みか ) ど 
うか を 検出 し ます 。 
IBM PC で は ,、 どの グラ フィ ックス アダ プ タ が 装着 され て いる か を 調べ , 
その アダ プ タ で 最も 高い 解像度 が 得 ら れる モー ド を 選択 し ます 。 グ ラフ ィ 
ックス アダ プ タ が な に も 検出 で き な い 場合 に は , * gz7gp が の ver に -2 が セ 
ッ ト さ れ , graphresult は -2 を 返し ます 。 
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* g7 の pg の ryer は , 使用 すべ き グ ラフ ィ ッ クス ドラ イ バ を 示す 整数 で す 。 こ 
れ に は , graphics.h で 定義 る S8 れ て いる 次 の よう な 列挙 型 grgpzcs み jyers 
の 定数 を 与え を る こと が で きま す 。 


ggpAicsy み ers 定数 数 値 
DETECT 0 (自動 検出 要求 ) 
CGA 1 
MCGA 2 
EGA 3 
EGA64 4 
EGAMONO 5 
IBM8514 6 
HERCMONO 7 
ATT400 8 
VGA 9 
PC3270 10 
PC98 11 (PC-9801 の み ) 
PC98GRCG 12 (PC-9801 の み ) 
PC98EGC 13 (PC-9801 の み ) 
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* gy の Pode は 初期 グラ フィ ックス モー ド を 示す 整数 で す (た だ し , 

* ggpg の rper が DETECT に 等 し い 場 合 に は , * gygpzode は 検出 され 
た ドラ イ バ に お いて 最も 高い 解像度 が 得 ら れる モー ド に セッ ト さ れ ま す )。 
* gg7 が Ode に は 、 graphics.h で 定義 き 8 れ て いる 以下 の よう な 列挙 型 
gcy odes の 定数 を 与え を る こと が で きま す 。 


ドラ イベ バ 8g/97ics 7 の es 値 横 X 縦 バレ ッ ト ペー ジ 
PC98 PC98C8 0 640※X400 8 色 2 
PC98C16 1 640※X400 16 色 2 
PC98GRCG PC98C8 0 640X400 8 色 2 
PC98C16 1 640X400 16 色 2 
PC98EGC PC98C8 0 640X400 8 色 2 
PC98C16 1 640X400 16 色 2 
CGA CGACO 0 320X200 CO 1 
CGAC1 1 320X200 C1 1 
CGAC2 2 320X200 C2 1 
CGAC3 3 320X200 C3 1 
CGAHI 4 640X200 2 色 1 
MCGA MCGACO 0 320X200 CO 1 
MCGAC1 1 320x200 Cl 1 
MCGAC2 2 320X200 C2 1 
MCGAC3 3 320X200 C3 1 
MCGAMED 4 640X200 2 色 1 
MCGAHI 5 640X480 2 色 1 
EGA EGALO 0 640X200 16 色 4 
EGAHI 1 640X350 16 色 2 
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EGA64 


EGAMONO 


HERC 


ATT400 


VGA 


PC3270 


IBM8514 


EGA64LO 
EGA64HI 


EGAMONOHI 
EGAMONOHI 


HERCMONOHI 


ATT400CO 
ATT400C1 
ATT400C2 
ATT400C3 
ATT400MED 
ATT400HI 


VGALO 
VGAMED 
VGAHI 


PC3270 


IBM8514HI 
IBM8514LO 


* 64K EGA モノ カー ド 
*※※ 256K EGA モノ カー ド 


640X200 
640X350 


640X350 
640X350 


720X348 


320X200 
320X200 
320X200 
320X200 
640X200 
640X400 


640X200 


640X350 


640X480 


720X350 


640X480 
024X768 


16 色 


16 色 
16 色 
16 色 


2 色 


256 色 
256 色 


2 ネ ※ 


注意 detectgraph を 直接 呼び 出す 主 な 理由 は , detectgraph が init- 
graph に 対し て 推奨 する グラ フィ ックス モー ド を 変更 する こと に あり ま 


す 。 


戻り 値 あり ませ ん 。 
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51Z 


可 搬性 detectgraph は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 
動作 し ます 。 


関連 項目 graphresult、 initgraph 
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drawpoly 


形式 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬性 


関連 項目 


多角 形 の 輪郭 を 描き ます 。 


#include <graphics.h> 
void far drawpoly (int zo 廊 な 。 int far 玉 Po の Po の な ) 


graphics.h 


drawpoly は , 頂点 の 数 が zzzpo が 5 の 多角 形 を , カレ ント ライ ンス タイ ル 
と カラ ー で 描き ます 。 

po の po 人 5 は 、 (7 の 025 X2 個 の ) 整数 の 並び を 指し ます 。 整数 の 各 ペ ア 
は , それ ぞ れ 多角 形 の 頂点 の x 座 標 と 座標 を 与え ます 。 


注意 : ヵ 個 の 頂点 か ら な る 閉じ た 図形 を 描く た め に は , ヵ 番 目 の 座標 が 0 番 
目 の 座標 に 等 し い ヵ 二 1 組 の 座標 を 、drawpoly に 渡さ な けれ ば な り ま せ 
ん 。 


多角 形 を 描い て いる と き に エラ ー が 発生 し た 場合 graphresult は -6 を 返 
し ます 。 


drawpoly は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ 


プ タ を 備え て いな けれ ば な り ませ ん )。 


fillpoly、 floodfill、 graphresult、 setwritemode 
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例 用 nc1ude <graphics.h> 
nc1ude <conio.h> 


main() 

(6 
1nt graphdriver = DETECT。 graphmodc: /* 自動 検出 を 要求 */ 
nt triangle[ ] = (50,100, 100,100, 150,150, 50,100) 
int rhombus[ ] = (50,10, 90,50, 50,.90, 10,50): 


1nitgraph(&graphdriver, &graphmode, "*): /* 初期 化 */ 


/* 三角 形 を 描く */ 
drawpoly(sizeof(triangle)/(2*sizeof(int) ) ,triang1e) : 


/* 平行 四辺 形 を 描い て フィ ル す る */ 
fi11poly(sizeof(rhombus) / (2*sizeof(1nt) ) rhombus): 


getche(): 
c1osegraph( ): 
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ellipse 


機能 


形式 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬性 


棒 円 弧 を 描き ます 。 


#include <graphics.h> 
void far ellipse (int *。 int y、 int srgg/e、 int ezdgzg/e, 
int x/gdizs、 int yg の js) ・ 


graphics.h 


ellipse は , 中 心 が ぶ ッ ), 水平 軸 と 鉛直 軸 が それ ぞ れ xzggis と yggies で 
与え られ る 椿 円 刀 を カレ ント ドロ ウ カ ラー で 描き ます 。 弧 は sgzg を か ら 
end2g/e まで で す 。 s7gzge 王 0 お よび ezdgzge ニ 360 の 場合 は , ellipse の 呼 
び 出 し は 完全 な 椿 円 を 描き ます 。 

ellipse に 与え る 角度 は 反 時 計 ま わり で , 0 度 が 時 計 で 3 時 の 方 向 , 90 度 が 12 
時 の 方 向 に な り ま す 。 


注意 : カレ ント ライ ンス タイ ル は 析 円 弧 に は 影響 を 与え を ませ ん 。 た だ し , 
ライ ン 幅 は 棒 円 弧 に 影響 し ます 。 


あり ませ ん 。 
eliipse は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 し 
ます (QBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ プ タ 


を 備え て いな けれ ば な り ま せん )。 


arc, circle、 fillellipse、 getaspectratio、 pieslice, sector, 
setaspectratio 


arc を 参照 し て くだ さい 。 
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fillellipse 


機能 


形式 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬性 


関連 項目 


522 


椿 円 を 描い て フィ ル し ます 。 


#include <graphics.h> 


void far fillellipse (int x、int ア ,。 int xyggds。 int gg7s) : 

graphics.h 

fillellipse は 、 中 心 が さ ア )、 水平 軸 と 鉛直 軸 が それ ぞ れ xyggis と gg の 2y 
で 与え られ る 椿 円 弧 を 描き , その 中 を カレ ント フィ ルカ ラー と フィ ル バ パタ 
ー ン で フィ ル し ます 。 

あり ませ ん 。 

fillellipse は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アダ 


プ タ を 備え て いな けれ ば な り ま せん )。 


arc, circle, ellipse、 getaspectratio、 pieslice, sector, 
setaspectratio 


arc を 参照 し て くだ さい 。 
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fillpoly 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


多角 形 を 描い て フィ ル し ます 。 


#include <graphics.h> 
void far fillpoly (int poi な 。 int far *※ Popo な ) ・ 


graphics.h 


fillpoly は 、 カレ ント ライ ンス タイ ル と カラ ー で 多角 形 を 描き (drawpoly 
と 同じ ), カ レン ト フ ィ ル スタ イル と フィ ルカ ラー で その 多角 形 を フィ ルレ し 
ます 。 

po の poizs は 、 (zi の iponfs X2) 個 の 整数 の 並び を 指し ます 。 整数 の 各 ベ ア 
は , それ ぞ れ 多角 形 の 頂点 の x 座 標 と 座標 を 与え ます 。 


あり ませ ん 。 
fillpoly は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 
し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アダ プ 


タ を 備 そ て いな けれ ば な り ませ ん )。 


drawpoly,floodfill, graphresult, setfillstyle 
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floodfill 


機能 指定 の 境界 カラ ー で 囲ま れ た 領 城 を フィ ル し ます 。 


形式 #include <graphics.h> 
void far floodfill(int *。 int ヶ , int 2oygey) : 


プロ ト タ イ プ graphics.h 


解説 floodfill は 、 ビッ トマ ッ プ デバ イス 上 の 閉じ た 領域 を フィ ル し ます 。 
(x) は , 閉じ た 領域 内 の シー ド ポ イン ト (フィ ル を 開始 する 点 ) で す 。 
境界 カラ ー 2orger で 囲ま れ た 領域 が . カ レン ト フ ィ ル パタ ー ン と フィ ルカ 
ラー で フィ ル さ れ ま す 。 シ ー ド ポイ ント が 閉じ た 領域 の 内 側 に ある 場合 は 
領域 の 内 側が フィ ル さ れ , 外側 に ある 場合 は 領域 の 外側 が フィ ル さ れ ま す 。 
将来 の パー ジョ ン と の 互換 性 を 保つ た め に は , 可能 な 限り floodfill で は な 
< fillpoly を 用 いて くだ さい 。 


注意 : IBM-8514 の ドラ イ バ で は , floodfill は 動作 し ませ ん 。 


戻り 値 領域 を フィ ル し て いる と き に エラ ー が 発生 し た 場合 , graphresult は -7 を 
返し ます 。 
可 搬 性 floodfill は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 


し ます QBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ アタ プ 
タ を 備え て いな けれ ば な り ま せん )。 


関連 項目 drawpoly, fillpoly、graphresult、 setcolor、setfillstyle 
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例 お nc1ude <graphcs.h> 


main() 
{ 
1nt graphdriver = DETECT, graphmode: /* 自動 検出 を 要求 ょ / 


1nitgraph(&graphdriver, &graphmode, ""): /* 初期 化 */ 


/* 3D バ ー を 描い て , 側面 と 上 面 を フィ ル す る */ 
setcolor(WHTTE) 

setf111style(HATCH_FILL。 LTGHTMAGENTA) 』 
bar3d(10,。 10, 100,。 100。 10, 1)』 
setEi11sty1e(SOLTD_FTLL。 LTGHTGREEN) : 


f1oodf111(102。 50,。 WHTYE) : /* 側面 を フィ ル +/ 
f1oodf111(50, 8, WHTTE): /* 上 面 を フィ ル */ 
c1osegraph(): 
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getarccoords 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


526 


arc の 最新 の 呼び 出し 時 の 座標 を 得 ます 。 


#include <graphics.h> 


Yoid far getarccoords (struct arccoordstype far * grccoor の 5) : 


graphics.h 


getarccoords は 、 gyccoor の s が 指す arccoordstype 構造 体 を , 最後 の arc 
の 呼び 出し に 関す る 情報 で 埋め ます 。 
arccoordstype 構造 体 は 、graphics.h で 次 の よう に 定義 8 され て いま す 。 
struct arccoordstype ( 

nt x。 Yi 

1nt xstart。 ystart。 xend。 yendi 
)j 
この 構造 体 の メン バ は , 弧 の 中 心 x), 出発 点 (xsfg77,yS7g77)、 終了 点 

(xezg の ez の) を 示し て いま す 。 こ れ ら の 値 は , 弧 の 端 を 通る 線 を 描く 必要 

が ある 場合 に 便利 で す 。 


あり ませ ん 。 

getarccoords は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 
動作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ ア 
ダ プ タ を 備え て いな けれ ば な り ませ ん )。 


arc, fillellipse、 pieslice、 sector 


arc を 参照 し て くだ さい 。 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


getaspectratio 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


例 


カレ ント グラ フィ ッ ク モ ー ド に お ける アス ペク ト 比 を 返し ます 。 


#include <graphics.h> 
void far getaspectratio(int far * xgsp。intfar 了 9 の ) ・ 


graphics.h 


ァ ア スペ クト 因子 * yg は , 10000 に 正規 化 さ れ て いま す 。 

PC-9801 で は ピク セル が 正方 形 に な っ て いる の で , ※ 9 の 三 *※ JO の と な 
り ま す 。 

IBM PC の 場合 , VGA を 除く すべ て の グラ フィ ックス アダ タプ タ で は , ビク 
セル は 横 よ り 縦 が 長い の で , * xgsp(x ア スペ クト 因子 ) は * Je より 小 
さい 値 に な り ま す 。 VGA で は ビク セル は 正方 形 な の で , * *95 の と 玉 ア の の 
は 等 し く な り ま す 。 一 般 に * ygsp と * xgsp の 関係 は 次 の よう に な っ て い 
ます 。 


* ァ gp 三 10000 
*※ xy めく 三 10000 


getaspectratio は 、 * xoy と *※ yg の の 値 を 得 ます 。 

あり ませ ん 。 

getarccoords は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 
動作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ ア 
ダ プ タ を 備え て いな けれ ば な り ま せん )。 Turbo Pascal に 同様 な ルー チン 
が あり ます 。 


arc、 circle, ellipse、 fillellipse. pieslice. sector, setaspectratio 


arc を 参照 し て くだ さい 。 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 一 


getbkcolor 
機能 カレ ント バッ ク グ ラウ ンド カラ ー を 得 ま す 。 
形式 #include <graphics.h> 
int far getbkcolor (void) : 
プロ ト タ イ プ graphics.h 
解説 getbkcolor は 、 カレ ント バッ ク グ ラウ ンド カラ ー を 返し ます (詳細 に つい 
て は setbkcolor を 参照 し て くだ さい )。 
戻り 値 getbkcolor は カレ ント バッ ク グ ラウ ンド カラ ー を 返し ます 。 
可 搬性 getbkcolor は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ 
プ タ を 備え て いな けれ ば な り ま せん )。 
関連 項目 getcolor、 getmaxcolor, getpalette, setbkcolor 
例 ま #1nclude <graphics .h> 
#1nc1ude <conio.h> 
ま 1nclude <dos.h> 
main() 
6 
1nt graphdrtver = DETECT, graphmodei  /* 自動 検出 を 要求 */ 
1nt svcolori 
1nitgraph(&graphdriver。 &graphmode, **): /* 初期 化 */ 
SVcolor = getbkco1or(): /* カレ ント バッ ク カ ラー を セー プ ブ */ 
setbkco1or(scco1or ^ 1): /* カレ ント バッ ク カ ラー を 変更  */ 
delay(5000): /* 5 秒間 待つ // 
setbkco1or(svco1or): /* 元 の カラ ー に 戻す */ 
getche( ) 
c1osegraph(): 
} 
528 
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getcolor 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


カレ ント ドロ ウ カ ラー を 得 ま す 。 


#include <graphics.h> 


int far getcolor(void) : 
graphics.h 


getcolor は ,、 カレ ント ドロ ウ カ ラー を 返し ます 。 

その 範囲 は 0 か ら getmaxcolor() まで で す 。 ドロ ウ カ ラー と は , 線 な ど を 描 
く と き に ビク セル に セッ ト さ れる 値 の こと で す 。 た と えば PC98C8 モ ー ド 
で は , getcolor () が 4 を 返せ ば カレ ント ドロ ウ カ ラー は 紫色 に な り ま す 。 


getcolor は カレ ント ドロ ウ カ ラー を 返し ます 。 


getcolor は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 
し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ アタ プ 
タ を 備え て いな けれ ば な り ま せん )。 


getbkcolor、 getmaxcolor、getpalette, setcolor 
#1nc1ude <graphics.h> 
1nc1ude <conto.h> 


main() 
6 


1nt graphdriver = DETECT。 graphnodei /* 自動 検出 を 要求 */ 
1nt svco1ori 


1nitgraph(&graphdriver,。 &graphmode, "*):  /* 初期 化 */ 


svcolor = getcolor(): /* カレ ント ドロ ウ カ ラー を セー プ ブ +/ 


setcolor(3)3 /* ドロ ウ カ ラー に バレ ッ ト 番 号 3 を 設定 */ 
ctrc1e(100, 100。 5):  /* カラ ー の 小さ な 円 */ 

setco1or( svcolor) : /* ドロ ウ カ ラー を 元 に 戻す */ 
getche( ) 

c1osegraph( ): 
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getdefaultpalette 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


530 


パレ ッ ト 定 義 構造 体 を 返し ます 。 


#include <graphics.h> 
void far * far getdefaultpalette(void) : 


graphics.h 


getdefaultpalette は , initgraph の 呼び 出し 中 に ドラ イ バ に よっ て 初期 化 
きれ た パレ ッ ト を 持っ て いる palettetype 構造 体 を 見 つけ ます 。 


getdefaultpalette は .、 カレ ント ドラ イ バ が 初期 化 さ れ た と き に , その ドラ 
イ バ に よっ て セッ ト ア ッ プ され た デフ ォ ル トバ レッ ト へ の ポイ ンタ を 返し 
ます 。 

getdefaultpalette は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で 
の み 動作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レ 


イア ダ プ タ を 備え て いな けれ ば な り ま せん )。 


getpalette、initgraph 
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getdrivername 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


カレ ント グラ フィ ックス ドラ イ バ の 名 前 を 持つ 文字 列 を 返し ます 。 


#include <graphics.h> 
char * far getdrivername (void) : 


graphics.h 


initgraph を 呼び 出し 後 , getdrivername は 現在 ロー ド さ れ て いる グラ フ 
ィ ッ クス ドラ イ バ の 名 前 を 返し ます 。 


getdrivername は ,、 グラ フィ ックス ドラ イ バ を 示す 文字 列 へ の ポイ ンタ を 
返し ます 。 


getdrivername は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
みろ 動作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ 


アダ プ タ を 備え て いな けれ ば な り ま せん )。 


getmodename, initgraph 
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getfillpattern 


機能 ユー ザ 定 義 の フィ ル パ タ ー ン を メモ リ に コピ ビー し ます 。 


形式 #include <graphics.h> 


void far getfillpattern (char far * pg7/erz) : 


プロ ト タ イ プ graphics.h 


解説 getfillpattern は setfillpattern で 設定 され た ユー ザ 定 義 の フィ ル バ パタ ー 
ン を , pg7er, が 指し て いる 8 バイ ト 領 域 に コピ ー し ます 。 
pg7e77 は 8 バイ ト 列 を 指す ポイ ンタ で , 各 バ イト は パタ ー ン 内 の 8 ビク セル 
に 対応 し て いま す 。 バ パタ ー ン 内 で 1 に 設定 され て いる ビッ ト に 対応 する ビク 
セル が プロ ッ ト さ れ ま す 。 た と えば , 次 の ユー ザ 定 義 の フィ ル バ パタ ー ン は 
チェ ッ カ ー 盤 を 表わし て いま す 。 


char checkerboard[8] = ( 


0xAA, 0x55。 0xAA。 0x55。 0xAA。 0x55。 0xAA, Ox55 
): 


戻り 値 あり ませ ん 。 


可 搬性 getfillpattern は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
みろ 動作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ 
アダ プ タ を 備え て いな けれ ば な り ま せん )。 


関連 事項 getfillsettings、 setfillpattern 
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getfillsettings 


機能 カレ ント フィ ル バ パタ ー ン と フィ ルカ ラー に 関す る 情報 を 得 ます 。 


形式 #include <graphicis.h> 
void far getfillsettings (struct fillsettingstype far * 6) : 


プロ ト タ イ プ graphics.h 


解説 getfillsettings は , / 訪 /o が 指し て いる fillsettingstype 型 構造 体 に . カレ 

ント フィ ル バ パタ ー ン と フィ ルカ ラー を 書き 込み ます 。fillsettingstype は , 
graphics.h の 中 で 次 の よう に 定義 され て いま す 。 
struct f111settingstype { 

1nt patterni /* カレ ント フィ ル バ パタ ー ン */ 

nt co1ori /* カレ ント フィ ルカ ラー  +#/ 
})j 
bar、bar3d、fillpoly、floodfill、pieslicee は 、 すべ て カレ ント フィ ル バ パタ 
ー ン と フィ ルカ ラー で 領域 を フィ ル し ます 。 定義 済み の フィ ル バ パタ ー ン は 
11 種 類 あ り ま す (ベタ 塗り や クロ スハ ッ チ , ドッ ト な ど )。 
定義 済み パ バターン の シン ポル 名 は , graphics.h の 7 pgrexs テー ブル に 
与え られ て いま す ( 下 の 表 を 参照 )。 こ れ に 加え て ユー ザ は 独自 の フィ ル バ 
ター ン を 定義 せる こと が で きま す 。 
Zg7e77 が 12 (USER_FILL) に 等 し い 場合 は 、 ユー ザ 定 義 の フィ ル バ パタ ー 
ン が 用 いら れ て いま す 。 それ 以外 の 場合 は 定義 済み パタ ー ン の 数 値 が 与え 
られ ます 。 
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戻り 値 


可 搬 性 


関連 事項 


534 


graphics.h で 定義 る 8 れ て いる 列挙 型 j/ gerz は , 定義 済み フィ ル バ タ ー 
ン の 名 前 と ユー ザ 定 義 パ ター ン の 指示 子 を 与え てい ます 。 


名 前 値 機能 説明 
EMPTY FILL 0 バッ ク グ ラウ ンド カラ ー で フィ ル ( 中 空 ) 
SOLID_FILL 1 ベタ 次 り 
LINE FILL 2 横線 で フィ ル 
LTSLASH FILL 3 ググ グ で フィ ル 
SLASH FILL 4 ノン ノ で フィ ル , 太線 
BKSLASH FILL 5 へ ヽ へ へ ヽ で フィ ル , 太線 
LTBKSLASH FILL 6 へ へ ヽ へ へ ヽ へ で フィ ル 
HATCH FILL 7 淡い ハッ チ (格子 ) で フィ ル 
XHATCH FILL 8 濃い クロ スハ ッ チ (斜め の 格子 ) で フィ ル 
INTERLEAVE FILL 9 イン ター リー プ 線 で フィ ル 
WIDE DOT_FILL 10 すき 間 が 広い 点 で フィ ル 
CLOSE_ DOT FILL 11 すき 間 が 狭い 点 で フィ ル 
USER_FILL 12 ユー ザ 定 義 の フィ ル バ パタ ー ン 


EMPTY FILL 以外 の も の は , カレ ント フィ ルカ ラー で フィ ル し ます 。 
EMPTY _ FILL は 、 カレ ント バッ ク グ ラウ ンド カラ ー を 用 いま す 。 


あり ませ ん 。 


getfillsettings は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
みろ 動作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ 
アダ プ タ を 備え て いな けれ ば な り ま せん )。 


getfillpattern,、 setfillpattern、 setfillstyle 
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例 nc1ude <graphics.h> 
す #1include <conio.h> 


main() 
{ 
1nt graphdriver = DETECT。 graphmode: /* 自動 検出 を 要求 メ / 
Struct fi11settingstyDe SaVei 
char savepattern[8]: 
char gray50[] = 
( Oxaa, Ox55, Oxaa, Ox55,。 Oxaa,。 Ox55。 Oxaa, Ox55 }: 


1nitgraph(&graphdriver,。 &graphmode, "")i  /* 初期 化 */ 
getEi11settings(&save): /* 現在 の 設定 を 得る */ 


1f (save.pattern == USER_FILL) /* ユー ザ 定 義 パ ター ン な ら ば +/ 
getfi11pattern(savepattern): /* その パタ ー ン を セー ブ */ 


setfi11style(SLASH PTLL, BLUE): /* フィ ルス タイ ル を 変更 */ 
bar( 0, 0, 100, 100): /* 青 で 終 線 フィ ル の バー を 描く */ 


setfi11pattern(&gray50, YELLOW) : /* ユー ザ 定 義 パ ター ン で ゞ / 
bar(100, 100, 200, 200): /* 貸 色 の バー を 描く */ 


1f (save.pattern == USER_FTLL) /* ユー ザ 定 義 パ ター ン な ら ば ょ */ 
/* ユー ザ 定 義 パ ター ン を 回 復 メ / 
setf111pattern(savepattern,。 8ave.COo1or): 
else /* 元 の スタ イル を 回 復 */ 
setfi11style(save.pattern,。 save.Color): 


getche(): 
c1osegraph( ) : 
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getgraphmode 


機能 


形式 


プロ ト タ イ プ ブ 


解説 


戻り 値 


可 搬性 


関連 項目 


例 


536 


カレ ント グラ フィ ックス モー ド を 返し ます 。 


#include <graphics.h> 
int far getgraphmode (void) : 


graphics.h 


getgraphmode を 呼び 出す 前 に 、 プ ログ ラム は initgraph の 呼び 出し に 成 
功 し て いな けれ ば な り ま せん 。 

graphics.h で 定義 され て いる 列挙 型 grgpfcs oe は 、 シ ステ ム 定 義 の グ 
ラフ ィ ッ クス モー ド の 名 前 を 与え て いま す 。 こ の 列挙 型 の 値 に つい て は 
initgraph の 解説 を 参照 し て くだ さい 。 


getgraphmode は 、 initgraph また は setgraphmode て 設定 され た カレ ン 
トグラフ ィ ッ クス モー ド を 返し ます 。 


getgraphmode は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
み 動 作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ 
アダ プ タ を 備え て いな けれ ば な り ま せん )。 


getmoderange, estorecrtmode, setgraphmode 


1nt cmodei 
cmode = getgraphmode( ) : /* カレ ント モー ド を セー ブ +#/ 
restorecrtmode( ) : /* テキ スト モー ド に 移行 */ 


printf("Now in text mode - * 
"Press any key to go back to graphics ..…*): 


getch(): 
setgraphmode(cmode) : /* グラ フィ ックス モー ド に 戻る */ 
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getimage 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 


指定 され た 領 城 の ビッ トイ メー ジ を メモ リ ヘ セー プ ブ し ます 。 


#include <graphics.h> 
void far getimage(int 6/7。 int 7op, int 7g が 7。 
int 2o77o7、 void far * が 72 の の) : 


graphics.h 


getimage は , 画面 上 の 長方形 領 城 の ビッ トイ メー ジ を メモ リ に コピ ー レ し 
ます 。/g77。 7op、 7g7/。 or7o77 は , コピ ー さ れる 画面 上 の 長方形 を 定義 し 
ます 。 gg の は ,、 ビッ トイ メー ジ が 格納 され る メモ リ 内 の 領域 を 指し ま 
す 。 この 領域 の 最初 の 2 ワー ド に は 長方形 の 幅 と 高 さ が 格納 され , 残り の 部 
分 に イメ ー ジ その も の が 格納 され ます 。 


あり ませ ん 。 
getimage は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アダ 


プ タ を 備え て いな けれ ば な り ま せん )。 


imagesize、 putimage、 putpixel 
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538 


ます 1nclude <al1loc.h> 
書 nc1ude <graphtcs.h> 


main() 


6 


1nt graphdriver = DETECT, graphmodei 
Yold *bufferi 
unstgned size 


1nitgraph(&graphdriver。 &graphmode 、 


size = imagesize(0, 0, 20。 10): 
buffer = malloc(slze)s 
getimage(0。 0。 20。 10。 buEfer)』 
た / 

putimage(0, 0, buffer, COPY_PUT): 
free(buffer): 


c1osegraph( ) 


/* 自動 検出 を 要求 */ 


0 /* 初期 化 */ 


/* イメ ー ジ 用 の メモ リ を 確保 */ 
/* イメ ー ジ を 取り 込む メ / 


/* イメ ー ジ を 復元 */ 
/* buffer を 解放 */ 
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getlinesettings 


形式 


プロ ト タ イ プ 


カレ ント ライ ンス タイ ル , バ パターン, 幅 を 得 ます 。 


#include <graphics.h> 
void far getlinesettings (struct linesettingstype far * me,7o) : 


graphics.h 


getlimesettings は , eo が 指し て いる linesettingstype 構造 体 に 、 カ 
レン トラ イン スタ イル , パタ ー ン , 幅 に 関す る 情報 を 書き 込み ます 。 
jinesettingstype 構造 体 は 、graphics.h で 次 の よう に 定義 され て いま す 。 


struct 11nesettingstype ( 
1nt 11nesty1ei 
unsigned upatterni 
Int thicknessi 

} 


es の e は , それ 以降 に 描か れる ライ ン の スタ イル を 指定 し ます (た と え を 
ば , 実線 、 点 線 , 一 点 鎖 線 , 破線 )。 graphics.h で 定義 され て いる ye se 
テー ブル に は , これ ら の 演算 子 の 名 前 が 与え を られ て いま す 。 


名 前 値 意味 
SOLID LINE 0 実線 
DOTTED LINE 1 点線 
CENTER LINE 2 一 点 鎖 線 
DASHED LINE 3 破線 
USERBIT LINE 4 ユー ザ 定 義 の ライ ンス タイ ル 
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戻り 値 


可 搬性 


関連 項目 


540 


czess は それ 以降 に 描か れる 線 の 幅 が , 普通 か 太い か を 指定 する も の 
し Ge Me 


名 前 値 意味 


NORM _WIDTH 1 1 ビク セル 幅 
THICK_ WIDTH 3 3 ピク セル 幅 


4pg7er7 は zespe が USERBIT LINE(4) の と き に の み 適 用 され る 16 ビ 
ッ ト パ ターン で す 。 その 場合 , パタ ー ン ワー ド 内 の 1 の ビッ ト に 対応 する ラ 
イン 内 の ビク セル が , カレ ント ドロ ウ カ ラー で 描か れ ま す 。 た と えば , 実 
線 は OxFFFF の upattern (すべ て の ピク セル の 描画 ) に 対し 、 破 線 は 
0x3333 ま た は 0x0FOF の xpgzez に 対応 し ます 。setlinestyle の 引数 /es- 
の e が USERBIT LINE(4) で な い 場 合 も , pgerz は 与え な けれ ば な り ま 
せん (無視 され ます が )。 


あり ませ ん 。 
getlinesettings は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
みる 動作 し ます (IBM PC で は 、 サ ポー ト す る グラ フィ ックス ディ スプ レイ 


アダ プ タ を 備え て いな けれ ば な り ま せん )。 


setlinestyle 
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例 nc1ude <graphics.h> 
nc1ude <conto.h> 


main() 

6 
1nt graphdriver = DETECT。 graphmode: /* 自動 検出 を 要求 メ / 
struct 1inesettingstype savelinei 


1nitgraph(&graphdriver。 &graphmode。 **)』 /* 初期 化 */ 


get1inesettings(&save1ine): /* ライ ンス タイ ル を セー プ +*/ 
set1nesty1e(SOLTD LTNE。 0。 THTCK_wTDTH): 
rectang1e(10, 10。 17, 15):  /* 太い ライ ン の 小さ な ボッ クス */ 
set1inestyle(savel1ine.1inestyle,  /* 元 の ライ ン 設 定 を 回 復 */ 
save11ne.upattern 。 
savel1ine.thickness): 
getche(): 
c1osegraph( ) : 
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getmaxcolor 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 
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setcolor 関数 に 渡す こと が で きる カラ ー の 最大 値 を 返し ます 。 


#include <graphics.h> 
int far getmaxcolor(void) : 


graphics.h 


getmaxcolor は 、 カ レン トグラフ ィ ッ クス ドラ イ バ と , カレ ント グラ フィ 
ックス モー ド に お いて 有効 な カラ ー の 最大 値 (パレ ッ ト サ イズ -1) を 返し 
ます 。 

PC-9801 で は ,、 getmaxcolor は 常に 15 を 返し 、 こ れ は setcolor に 渡す 数 値 
は 0 か ら 15 ま で が 有効 で も る こと を 意味 し ます 。 

IBM PC の 場合 、 た と えば 256K の EGA で は , getmaxcolor は 常に 15 を 返 
し , これ は setcolor に は 0 か ら 15 ま で の 数 値 を 指定 で きる こと を 意味 し ま 
す 。 また , CGA の 高 解像度 モー ド や Hercules モノ クロ アダ プ タ で は , 0 お 
よび 1 の カラ ー し か サポ ー ト し て いな いた め , getmaxcolor は 常に 1 を 返し 
ます 。 


getmaxcolor は 使用 で きる カラ ー の 最大 値 を 返し ます 。 
getmaxcolor は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 
動作 し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ ア 


ダ プ タ を 備え て いな けれ ば な り ま せん ) 。 


getbkcolor、 getcolor、 getpalette, getpalettesize, setcolor 
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getmaxmode 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


カレ ント ドラ イ バ て 使用 で きる 最大 の モー ド 番 号 を 返し ます 。 


#include <graphics.h> 


int far getmaxmode(void) ・ 


graphics.h 


getmaxmode は , 現在 ロー ド さ れ て いる ドラ イ バ て 使用 可能 な 最大 の モー 
ド 番 号 を 、 その ドラ イ バ か ら 直 接 取り 出し て 返し ます 。getmaxmode は 、 
サー ド パ ペー ティ が 提供 する ドラ イ バ に 対し て も 機能 し ます (getmoderan- 
ge は デフ ォ ル ト の ドラ イ バ に 対し て し か 機能 し ませ ん )。 モ ー ド の 最小 値 
は 0 で す 。 


getmaxmode は 、 カ レン トド ライ バ に お いて 使用 可能 な モー ド の 最大 値 を 
返し ます 。 


getmaxmode は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 
動作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ ア 
ダ プ タ を 備え て いな けれ ば な り ませ ん )。 


getmodename, getmoderange 
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getmaxx 
機能 画面 上 の * 座 標 の 最大 値 を 返し ます 。 
形式 #include <graphics.h> 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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int far getmaxx (void) : 


graphics.h 


getimaxx は ,、 カ レン トグラフ ィ ッ クス ドラ イ バ と , カレ ント グラフィック 
スモ ー ド で 有効 な 、 * の 最大 値 (画面 に 対す る 相対 値 ) を 返し ます 。 
PC-9801 で は , getmaxx は 常に 639 を 返し ます 。 

IBM PC の 場合 ,. た と えば CGA の 320X200 モ ー ド で は , getmaxx は 319 を 
返し ます 。 

getmaxx は ,、 セン タリ ング や 画面 上 の 領域 の 境界 を 決定 する 際 に 有用 で 
すき 


getmaxx は , 画面 座標 に お ける x 座 標 の 最大 値 を 返し ます 。 

getmaxx は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 
し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アタ ダ タプ 
タ を 備え て いな けれ ば な り ま せん )。 


getmaxy、 getx 


printf("The screen resolution 1s zd pixe1s by zd pixele.\nr, 
getmaxx( )+1 。 getmaxy( )+1 ) 
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getmaxy 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


画面 上 の 了 座 標 の 最大 値 を 返し ます 。 


#include <graphics.h> 
int far getmaxy (void) : 


graphics.h 


getmaxy は 、 カ レン トグラフ ィ ッ クス ドラ イ バ と , カ レン トグラフ ィ ッ ク 
スモ ー ド で 有効 な , 了 の 最大 値 (画面 に 対す る 相対 値 ) を 返し ます 。 
PC-9801 で は , getmaxy は 常に 399 を 返し ます 。 

IBM PC の 場合 , た と えば CGA の 320X200 モ ー ド では, getmaxx は 199 を 
返し ます 。 

getmaxy は 、 セ ンタ リン グ や 画面 上 の 領域 の 境界 を 決定 する 際 に 有用 で 
す 。 


getmaxy は 画面 座標 に お ける 座標 の 最大 値 を 返し ます 。 

getmaxy は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 
し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ タプ 
タ を 備え て いな けれ ば な り ま せん )。 


getmaxx、 gety 


getmaxx を 参照 し て くだ さい 。 
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getmodename 


機能 


形式 


プロ ト タ イ プ 


解説 
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546 


グラ フィ ックス モー ド 名 を 得 ます 。 


#include <graphics.h> 


char * far getmodename(int zzode zzzz の er) : 
graphics.h 


getmodename は カレ ント グラ フィ ックス ドラ イ バ の ode ziper に よ 
っ て 指定 され た モー ド の 名 前 を 示す 文字 列 へ の ポイ ンタ を 返し ます 。 モー 
ド 名 は ドラ イ バ ご と に 組み 込ま れ て いま す 。 返 され る 値 は 、 メニ ュー を 作 
成 し た り ス テー タス を 表示 し た りす る 際 に 便利 で す 。 
PC-9801 で は 以下 の よう な 文字 列 が 返さ れ ま す 。 


Ode の er 文字 列 


】 


"640 x 400 PC9801 8 COLOR" 
1 "640 x 400 PC9801 16 COLOR" 


getmodename は モー ド 名 へ の ポイ ンタ を 返し ます 。 

getmodename は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
みろ 動作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ 
アダ プ タ を 備え て いな けれ ば な り ま せん )。 


getdrivername, getmaxmode, getmoderange 
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getmoderange 


機能 指定 の グラ フィ ックス ドラ イ バ て で 有効 を モー ド の 範囲 を 得 ます 。 


形式 #include <graphics.h> 
void far getmoderange(int grgp が grzyer。 int far * /ozoge, 
int far * yzogde) : 


プロ ト タ イ プ graphics.h 


解説 getmoderange は 、 与 えら れ た グラ フィ ックス ドラ イベ gygpg の ver に お 
いて 有効 を な ケラ フィ ックス モー ド の 範囲 を 得 ます 。 許 され る モー ド の 最小 
値 は * /pzzode に 返さ れ , 最大 値 は * ん zzoge に 返さ れ ま す 。 gygp が ger と 
し て 無効 な グラ フィ ックス ドラ イ バ が 指定 され る と, * /pzogde と 
* 2404@ は と も に -1 に セッ ト さ れ ま す 。 * gp の yer の 値 が -1 の 場合 に 
は , 現在 ロー ド さ れ て いる ドラ イ バ を 指定 する こと に な り ま す 。 


戻り 値 あり ませ ん 。 
可 搬性 getmoderange は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 


みろ 動作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ 
アダ プ タ を 備え て いな けれ ば を り ま せん )。 


関連 項目 getgraphmode, getmaxmode、 getmodename, initgraph, setgraphmode 
例 nclude <graphics.h> 
main() 
{ 
nt 1o, hii 


getmoderange(PC98, &1o。 &hi ) 
printE("PC-9801 supports modes zd through Zdwn*。 1o。 hi): 
) 
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カレ ント バレット に 関す る 情報 を 得 ます 。 


#include <graphics.h> 
void far getpalette(struct palettetype far * pg/e/e) : 


graphics.h 


getpalette は 、 カ レン トバ ペレット の サイ ズ と 各 カ ラー に 関す る 情報 を , pg/- 
efe が 指す palettetype 型 の 構造 体 に 書き 込み ます 。 
getpalette で 用 いら れる palettetype 型 構造 体 と 定数 MAXCOLORS は , 
graphics.h の 中 で 次 の よう に 定義 され て いま す 。 
#define MAXCOLORS 15 
struct palettetype { 

unsigned char sizei 


signed char colors[MAXCOLORS + 1]: 
} 


sze は , カレ ント グラフィ ックス ドラ イ バ と , カレ ント グラ フィ ックス モー 
ド で の , パレ ッ ト 中 の カラ ー の 数 で す 。 

coors は 、 パレ ッ ト の 中 の それ ぞ れ の 項目 に 対応 し た 実際 の カラ ー の 番号 
を 要素 と する sze バイ ト の 配列 で す 。 


注意 : getpalette は , IBM-8514 ド ライ バ で は 使用 で きま せん 。 

あり ませ ん 。 

getpalette は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アダ 


プ タ を 備え て いな けれ ば な り ま せん )。 


getbkcolor、 getcolor, getdefaultpalette, getmaxcolor, 
setallpalette, setpalette 
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例 すず 1nc1ude <graphics .h> 
nc1ude <stdio.h> 
nclude <conio.h> 


main() 

6 
nt graphdriver = DETECT。 graphmodes /* 自動 検出 を 要求 */ 
struct palettetype palettez 
1nt co1ori 


1nitgraph(&graphdriver。 &graphmode, *"*), /* 初期 化 */ 


getpalette(&palette): /* カレ ント バレ ッ ト を 得る */ 
for(color = 0: color < palette.sizei co1or++) 
い 
setfi11sty1e(SOLTD FTLL, co1or): /* 様々 な 色 の バー を 描く */ 
bar(20*(co1or-1), 0。 20*color。 20): 


} 
1f (palette.size > 1) /* カラ ー が 複数 あれ ば ょ */ 
do /* キー が 押さ れる まで +*/ 
setpalette(random(palette.size), random(palette.size)): 
while(1kbhit() ): /* ラン ダム に 切り 換え る */ 
getch() /* 入力 され た 文字 は 捨て る */ 
} 
seta11palette(&palette): /* パレ ッ ト を 元 に 戻す */ 
c1osegraph( ) : 
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パレ ッ ト カ ラー 参照 テー ブル の サイ ズ を 返し ます 。 


#include <graphics.h> 
int far getpalettesize(void) : 


graphics.h 

getpalettesize は 、 カ レン トグラフ ィ ッ クス モー ド で , いく つの パレ ッ ト が 
設定 で きる か を 得る た め に 使用 し ます 。 

PC-9801 で は 、 getpalettesize は 常に 16 を 返し ます 。 

IBM PC の 場合 , た と えば EGA の カラ ー モ ー ド で は 16 が 返さ れ ま す 。 
getpalettesize は 、 カ レン トバ レット の 項目 数 を 返し ます 。 
getpalettesize は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
みろ 動作 し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ 


アダ プ タ を 備え て いな けれ ば な り ま せん )。 


setpalette、 setallpalette 
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ーーーー ニ ニー ニー ュー ニー ニー ニー ニー ニー 一 
getpixel 


機能 指定 され た ビク セル の カラ ー を 得 ま す 。 


形式 #include <graphics.h> 
unsigned far getpixel(int x。int 了 ) : 


プロ ト タ イ プ graphics.h 


解説 getpixel を 使う と 、(x) に 位置 する ビク セル の カラ ー が 得 ら れ ま す 。 
戻り 値 getpixel は 指定 され た ビク セル の カラ ー を 返し ます 。 
可 撫 性 getpixel は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 


し ます 1BM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ アタ プ 
タ を 備え て いな けれ ば な り ま せん ) 。 


関連 項目 getimage、 putpixel 
例 #Hnclude <graphics.h> 
#1nclude <conio.h> 
main() 
{ 
1nt graphdriver = DETECT。 graphmode: /* 自動 検出 を 要求 */ 


nt 1。 color。maxi 


nitgraph(&graphdriver。 &graphmode , 3 /* 初期 化 */ 
max = getmaxco1or() + 1: 


/* ライ ン 上 の ビク セル の カラ ー を 変化 させ る に 
for ( せ =1: < 200』 ヨ ++) ( 

co1or = getpixe1(1。i): 

putptxe1(1。 1。 (color へ 1) z max): 


getche( ) 
c1osegraph() : 
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現在 の グラ フィ ッ ク テ キス ト の 設定 に 関す る 情報 を 返し ます 。 


#include <graphics.h> 
void far gettextsettings(struct textsettingstype far 7ex/ の Pez/ の 6) : 


graphics.h 


gettextsettings は 、/ex7 の pez/o が 指す textsettingstype 型 構造 体 に 、 カ 
レン ト テ キス ト フ ォ ン ト , テキ スト の 向き , 文字 サイ ズ , 位置 合わ せ に つ 
いて の 情報 (settextstyle や settextjustify で セッ ト さ れる 情報 ) を 書き 込 
みろ ます 。 

gettextsettings で 用 いら れる textsettingstype 型 構造 体 は 、graphics.h 
の 中 で 次 の よう に 定義 きれ て いま す 。 


struct textsettingstype ( 
1nt fonti 
1nt directioni 
1nt charsizei 
nt horizi 
nt verti 


) 


各 フ ィ ー ル ド の 意味 に つい て は settextstyle を 参照 し て くだ さい 。 

あり ませ ん 。 

gettextsettings は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で 
の みろ 動作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レ 


イア ダ プ タ を 備え て いな けれ ば な り ま せん ) 。 


outtext、 outtextxy、 settextjustify、 settextstyle, 
setusercharsize, textheight, textwidth 
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例 nc1ude <graphics.h> 
1nc1ude <conio.h> 


main() 


6 
1nt graphdriver = DETECT。 graphmode: /* 自動 検出 を 要求 */ 
struct textsettingstype o1dtext: 


nttgraph(&graphdriver。 &graphmode,""): /* 初期 化 */ 
gettextsettings(&o1dtext ) : /* 現在 の 設定 を 得る */ 


/* 水平 方 向 , 上 左 揃 え に 切り 替え 

ゴシック フォ ント , 因子 5 が 
settextjust1fy(LEPT TEXT。 TOP TEXT): 
settextsty1e(GOTHTC FONT, HORIZ_DIR, 5): 
outtext(*Gothic Text"): 


/* 設定 を 元 に 戻す */ 

settextjust1fy(o1dtext .horiz。 o1dtext.vert)』 

settextstyle(o1dtext .font , o1dtext .direction, 
o1dtext.charsize): 

getche( ) 

c1osegraph( ) : 
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getviewsettings 


機能 カレ ント ビュ ー ポ ー ト に 関す る 情報 を 得 ます 。 


形式 #include <graphics.h> 
void far getviewsettings(struct viewporttype far * wiewpo/7) ・ 


プロ ト タ イ プ graphics.h 


解説 getyiewsettings は 、wewpor が 指す viewporttype 型 構造 体 に に. カレ ント 
ビュ ー ポ ー ト に 関す る 情報 を 書き 込み ます 。 
getviewport が 用 いる viewpoint 型 構造 体 は graphics.h の 中 で 次 の よう 
に 定義 きれ て いま す 。 
struct viewporttype ( 


nt 1eft。 top。r1ght。 bottomi 
nt c1ipf1agi 


} 
戻り 値 あり ませ ん 。 
可 搬性 getviewsettings は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で 


の みろ 動作 し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レ 
イア ダ プ タ を 備え て いな けれ ば な り ま せん )。 


関連 項目 clearviewport、 getx, gety, setviewport 
例 struct viewporttype viewi 
getviewsettings(&view): /* 現在 の 設定 を 得る */ 
1E (lview.c1ip) /* クリ ッ ピ ング が オフ で あれ ば */ 
setytewport(yew.1eft。 ylew.tOD。 /* オン に する */ 


Yew.right, vew.bottom。1): 
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getx 

機能 現在 位置 の ェ 座 標 を 返し ます 。 

形式 #include <graphics.h> 
int far getx (void) : 

プロ ト タ イ プ graphics.h 

解説 getx は , 現在 位置 の ェ 座 標 を 返し ます 。 返さ れる 値 は ビュ ー ポ ボー ト 相 対 で 
す 。 

戻り 値 getx は 、CP の 座標 を 返し ます 。 

可 搬性 getx は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 し ま 
す (QBM PC で は , サポ ー ト する グラ フィ ッ クス ディ スプ レイ アダ プ タ を 
備え て いな けれ ば な り ま せん )。 

関連 項目 getmaxx, getmaxy, getviewsettings, gety 

例 1nt oldx, oldyi 


/* カレ ント 位置 を セー プ +*/ 
oldx = getx(): 
o1dy = gety(): 


circ1e(100, 100, 2): /* [100,100] に 小さ な 丸 を 描く */ 
moveto(99。 100) 

1inere1(2,。 0): 

moveto(o1dx。 o1dy) : /* 元 の 位置 に 戻る */ 
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現在 位置 の 了 座 標 を 返し ます 。 


#include <graphics.h> 
int far gety (void) : 


graphics.h 


gety は , 現在 位置 の 座標 を 返し ます 。 返さ れる 値 は ビュ ー ポ ー ト 相対 で 
す 。 


gety は 、CP の 了 座 標 を 返し ます 。 

gety は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 し ま 
す (QBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アダ プ タ を 
備え て いな けれ ば な り ま せん )。 


getmaxx、 getmaxy, getviewsettings, getx 


getx を 参照 し て くだ さい 。 
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graphdefaults 


プロ ト タ イ プ 


解脱 


戻り 値 


可 搬性 


関連 項目 


グラ フィ ックス の すべ て の 設定 を アデ フォル ト に リセ ッ ト し ます 。 


#include <graphics.h> 
void far graphdefaults(void) : 


graphics.h 


graphdefaults は 、 あ ら ゆ る グラ フィ ックス の 設定 を デフ ォ ル ト に リセ ッ 
ト し ます 。 こ れ は 以下 の 動作 を 意味 し ます 。 


較 ビ ュー ポー ト を スク リー ン 全 体 に 設定 する 。 

圏 カレ ント 座標 を (0.0) に 動か す 。 

一 デフ ォ ル ト の ペレット カ ラー, バッ ク グ ラン ドカ ラー, ドロ ウ カ ラー 
を セッ ト す る 。 

罰 デ フォ ルト の フィ ルス タイ ル と フィ ル バ パタ ー ン を セッ ト す る 。 

還 デ フォ ルト の テキ スト フォ ント と 位置 合わ せ を モット する 。 


あり ませ ん 。 
graphdefaults は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
みろ 動 作 し ます (IBM PC て で は, サポ ー ト する グラ フィ ックス ディ スプ レイ 


アグ プ タ を 備え て いな けれ ば な り ま せん )。 


initgraph 
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エラ ー メ ッ セ ー ジ 文字 列 へ の ポイ ンタ を 返し ます 。 


#include <graphics.h> 
char * far grapherrormsg (int eryorcoge) : 


graphics.h 

grapherrormsg は , graphresult が 返し た エラ ー コ ー ド に 対応 する エラ ー 

メッ セー ジ 文 字 列 を 指す ポイ ンタ を 返し ます 。 

eyorcode の 値 と 対応 する 文字 列 に つい て は 、 graphresult の 解説 を 参照 し 

て くだ さい 。 

grapherrormsg は 、 エラ ー メ ッ セ ー ジ 文字 列 を 指す ポイ ンタ を 返し ます 。 
grapherrormsg は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で 

の みろ 動作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レ 


イア ダ プ タ を 備え て いな けれ ば な り ま せん )。 


graphresult 
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ーーーーーーーーーーーーーーーーーーーー ブ ーー 


_graphfreemem 

擬 能 グラ フィ ックス メモ リグ の 解放 ルー チン へ の フッ ク で す 。 

形式 #include <graphics.h> 
void far graphfreemem (void far * p な か , unsigned sze) : 

プロ ト タ イ プ graphicsh 

解説 グラ フィ ックス ライ ブラリ 中 の ルー チン は 。 _graphfreemem を 呼び 出し 
て , 前 に _graphgetmem を 使っ て 割り 当て た メモ リ を 解放 し ます 。 ユー ザ 
独自 の _graphfreemem の バー ジョ ン を 定義 すれ ば (これ は 上 の 人 宜 言 通り 
に 正確 に 定 言 し を な けれ ば いけ ませ ん ), グラ フィ ックス ライ プラ リ の メ モリ 
管理 の 方 法 を 変更 する こと が で きま す 。 デ フォ ルト ペー ジョ ン で は , この 
ルー チン は free を 呼び 出す だ け で す 。 

戻り 値 あり ませ ん 。 

可 搬性 -graphfreemem は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で 
の みろ 動作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レ 
イア ダ プ タ を 備え て いな けれ ば な り ま せん )。 

関連 項目 _graphgetmem, setgraphbufsize 
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例 /* ユー ザ 定 義 の グラ フィ ックス メモ リ 管 理 ル ー チ ン の 例 */ 


旭 nc1ude <graphtcs.h> 
太 ncude <stdio.h> 
nc1ude <conio.h> 
nc1ude <process.h> 
nc1ude <a11oc.h> 


main() 

( 
1nt errorcode: 
nt graphdriver: 
1nt graphmodei 


graphdriver = DETECT。 

1nitgraph(&graphdriver, &graphmode, "ar" ) 

errorcode = graphresu1t(): 

1f (errorcode 1= grOk) 

( 
Printf("graphics errori Zn"。 grapherrormeg(errorcode ) ) : 
exit(1) 

い 


settextety1e(COTHTC_PONT。 HORTZ_DTR, 4): 
outtextxy(100。 100, *BGT TEST"): 
getche(): 
c1osegraph( ) 

} 


Vold far *far graphgetmem(unsigned size) 

い 
Printf(*_graphgetmem ca11ed [eze=zd] -- hit any key', size): 
getch():』 printf("Wn")j 
return(farmal11oc(stze)): /* far ヒ ー プ を 使用 */ 

} 


Yold far _graphfreemem(yoid Ear *ptr。 unslgned size) 

{ 
prtntf(*_graphfreemem ca11ed [sze=zd] -- hit any key*, sze): 
getch( ): printE("Wn)i 
farfree(ptr): /* size は 使わ れ な い */ 

} 
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ーーーーーーーーーーーーーーーーーーーーーーー ノ パパ OO 


_graphgetmem 

揚 能 グラ フィ ックス メモ リ の 割り 当て ルー チン へ の フッ ク で す 

形式 #include <graphics.h> 
void far * far _graphgetmem (unsigned sze) : 

プロ ト タ イ プ graphicsh 

解説 グラ フィ ックス ライ プラ リ 中 の ルー チン は , 通常 graphgetmem を 呼び 出 
し て , 内 部 ペッ ファ , グラ フィ ックス ドラ イ バ , 文字 セッ ト の た め の メ モ 
リ を 割り 当て ます ( graphgetmem を 呼び 出す の は ラ イプ ラリ ルー チン で 
あお あり, ユーザ プロ グラ ム で は あり ませ ん )。 ユ ー ザ 独自 の _graphgetmem を 
定義 すれ ば (形式 に 示さ れ て いる と お り に 正確 に 宣言 し を な けれ ば いけ ませ 
ん が ), グラ フィ ックス ライ プラ リ の メモ リ 管理 の 方 法 を 変更 する こと が で 
きま す 。 デフ ォ ル ト で は 、 この ルー チン は malloc を 呼び 出す だ け で す 。 

戻り 値 あり ませ ん 。 

可 折 性 _graphgetmem は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
ろ 動 作 し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ティ スプ レイ 
アダ プ タ を 備え て いな けれ ば な り ま せん )。 

関連 項目 _graphfreemem, initgraph、 setgraphbufsize 

例 _graphfreemem を 参照 し て くだ さい 。 


グラ フィ ックス 関数 リフ ァ レ ンス 561 


graphresult 


機能 失敗 し た 最後 の グラ フィ ックス 操作 に 対す る エラ ー コ ー ド を 返し ます 。 


形式 #include <graphics.h> 


int far graphresult (void) ・ 


プロ ト タ イ プ graphics.h 


解説 graphresult は 、 エ ラー と な っ た 最後 の グラ フィ ックス 操作 に 対す る エラ 
ー コ ー ド を 返し , エラ ー レ ベル を grOk に リセ ッ ト し ます 。 
次 の 表 は , graphresult が 返す エラ ー コ ー ド を 示し て いま す 。 こ の 表 の 中 の 
定数 は , graphics.h の 中 で 列挙 型 grgpics eyory と し て 定義 きれ て いま 


エラ ー ggp/cs eors 


対応 する エラ ー メ ッ セ ー ジ 文字 列 


コー ド 定数 / 意味 
0 grOk No error 
エラ ー な し 
-1 grNoInitGraph (BGI) graphics not installed(use init- 


<2 grNotDetected 


-3 grFileNotFound 
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graph) 

(BGI) グラ フィ ックス が 組み 込ま れ て い 
な い (initgraph を 使用 せよ ) 

Graphics hardware not detected 
グラ フィ ックス ハー ドウ ェ ア が 検出 で き 
な い 

Device driver file not found 

デバ イス ドラ イ バ フ ァイル が みつ か ら な 


い 
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-4 grlInvalidDriver Invalid device driver file 
デバ イス ドラ イ バ フ ァイル が 正しく な い 


の grNoLoadMem Not enough memory to load driver 
ドラ イ バ を ロー ド す る メモ リ が 不足 

-6 grNoScanMem Out of memory in scan fill 
スキ ャ ン フ ィ ル で メモ リ が 不足 

-7 grNoFloodMem Out of memory in flood fill 
フラ ッ ド フィ ル で メモ リ が 不足 

-8 grFontNotFound Font file not found 
フォ ント ファ イル が みつ か ら な い 

-9 grNoFontMem Not enough memory to load font 
フォ ント を ロー ド す る メモ リ が 不足 

-10 grInvalidMode Invalid graphics mode for selected 
driver 


選ん だ ドラ イ バ に 対し て グラ フィ ックス 
モー ド が 正しく な い 

=11 grError Graphics error 
グラ フィ ックス エラ ー 


~-12 grIOerror Graphics I/O error 
グラ フィ ックス 1I/O ェ ラー 
=43 grInvalidFont Invalid font file 


フォ ント ファ イル が 正しく な い 
-14 grlInvalidFontNum Invalid font number 

フォ ント 番号 が 正しく な い 
-15 grlnvalidDeviceNum Invalid device number 

デバ イス 番号 が 正しく な い 
-18 grlnvalidVersionNum Invalid device number 

デバ イス 番号 が 正しく な い 


ーーーーーーーーーーーーーーーーーーーーーーーーTT 


graphresult が 呼び 出さ れる と , エラ ー コ ュー ド は 0 に リセ ッ ト さき され る こと に 
注意 し て くだ さい 。 し た が っ て , graphresult が 返し た 値 を いっ た ん 変数 に 
代入 し て か ら テ スト すべ き で す 。 
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戻り 値 


可 搬性 


564 


graphresult は , 現在 の グラ フィ ックス エラ ーー 番号 . すなわち -18 一 0 の 功 囲 
の 整数 を 返し ます 。 grapherrormsg を 使う と graphresult が 返し た エラ 
ー コ ー ド に 対応 する エラ ー メ ッ セ ー ジ 文字 列 を 指す ポイ ンタ を 得る こと が 
で きま す 。 


graphresult は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 
動作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ ア 
ダ プ タ を 備え て いな けれ ば な り ま せん )。 


detectgraph、drawpoly、fillpoly、floodfil、grapherrormsg, 
initgraph、pieslice、 registerbgidriver、registerbgifont, 
setallpalette, setcolor、 setfillstyle、 setgraphmode, 
setlinestyle, setpalette、settextjustify、 settextstyle, 
setusercharsize、 setviewport、 setvisualpage 
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magesize 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 


ビッ トイ メー ジ の 格納 に 必要 な バイ ト 数 を 返し ます 。 


#include <graphics.h> 
unsigned far imagesize(int /g/7。 int 7op, int 7g が 7。 int po77ozz) : 


graphics.h 


imagesize は getimage に よっ て ビッ トイ メー ジ を 格納 する の に 必要 な 
メモ リ 領 域 の サイ ズ を 決定 し ます 。 返 され る バイ ト 数 に は ,、 イメ ー ジ の 幅 
と 高き の た め の メ モリ 領域 も 含ま れ て いま す 。 選 ん だ イメ ー ジ に 対し て 必 
要 と な る 大 き さ が 64K-1 バ イト 以上 の 場合 , imagesize は OxFFFF (-1) を 
返し ます 。 


imagesize は 必要 と され る メモ リ 領 域 の サイ ズ を バイ ト 単 位 で 返し ます 。 
imgesize は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 
し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ タプ 


タ を 備え て いな けれ ば な り ま せん )。 


getimage、 putimage 
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initgraph 


機能 


形式 


プロ ト タ イ プ 


解脱 


566 


グラ フィ ックス シス テム を 初期 化し ます 。 


#include <graphics.h> 
Yoid far initgraph(int far * grgpgrzyer、 int far * g7gp7oge, 
char far * pg77/o の ye/) : 


graphics.h 


initgraph は , ディ スク か ら グ ラフ ィ ッ クス ドラ イ バ を ロー ド ( も し く は 登 
録 され て いる ドラ イ バ を 有効 に ) し 、 シス テム を グラ フィ ックス モー ド に 
し て , グラ フィ ックス シス テム を 初期 化し ます 。 

グラ フィ ックス シス テム を 起動 する に は , まず 最初 に initgraph を 呼び 出 
し ます 。 initgraph は 、 グ ラフ ィ ッ クス ドラ イ バ を ロー ド し , シス テム を グ 
ラフ ィ ッ クス モー ド に し ます 。initgraph に は , 特定 の グラ フィ ックス ドラ 
イ バ お よび モー ド を 指定 する こと が で きま す 。 あ る い は , 実行 時 に ハー ド 
ウェ ア を 調べ て 自動 的 に 最適 な ドラ イ バ を ロー ド す る よう に 指示 する こと 
(自動 検出 ) も で きま す 。 

自動 検出 を 指示 する と, initgraph は グラ フィ ックス ドラ イ バ と モー ド を 
選択 する た め に detectgraph を 呼び 出し ます 。initgraph は さら に , すべ て 
の グラ フィ ックス の 設定 (現在 位置 、 パ レッ ト , カラ ー, ビュ ー ポ ー ト な 
ど ) を デフ ォ ル ト に セッ ト し , graphresult を (に リセ ッ ト し ます 。 

通常 initgraph は ( graphgetmem を 使っ て ) ドラ イ バ に 必要 な メモ リ を 
割り 当て , ディ スク か ら . BGI ファ イル を 読み 込む こと に よっ て , グラ フィ 
ックス ドラ イ バ を ロー ド し ます 。 こ の よう に 動 的 に ロー ド す る 方 法 の 他 に , 
グラ フィ ックス ドラ イ バ フ ァイル (場合 に よっ て は その いく つか ) を 実行 
可能 プロ グラ ム フ ァ イル に 直接 リン ク す る 方 法 が あり ます (この 詳細 に つ 
いて は ユー ザー ズ ガ イド 付録 C の BGIOBJ の 節 を 参照 し て くだ さい )。 
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pg7 が 7ogrzyer に は 。 initgraph が グラ フィ ックス ドラ イ バ を 探索 する ディ レ 
クト リバ ス を 指定 し ます 。 initgraph は , まず pg77ogryer で 指定 され た パ 
ス で 探索 を 行ない , (グラ フィ ックス ドラ イ バ が そこ に な けれ ば ) 次 に カレ 
ント ディ レク トリ で 探索 を 行ない ます 。 し た が っ て , pg//ogrzyer が NULL 
で ある と , ドラ イ バ フ ァイル (*.BGI) は カレ ント ディ レク トリ に な けれ 
ば な り ま せん 。 こ の バス は 、settextstyle が スト ロー ク 文 字 フ ォ ン ト フ ァ イ 
ル (*.CHR) を 探索 する バス で も あり ます 。 

* gg の ver は 、 使 用 され る べき グラ フィ ックス ドラ イ バ を 指定 する 整 
数 で す 。 こ の 値 に は , graphics.h に 定義 され て いる 次 の 表 に 示す 列挙 弄 
grpZcs の ers 中 の 定数 を 使う こと が で きま す 。 


grgp ん cs の ivers 定数 数 値 
DETECT 0 (自動 検出 要求 ) 
CGA 1 
MCGA 2 
EGA 3 
EGA64 4 
EGAMONO 5 
IBM8514 6 
HERCMONO 4 
ATT400 8 
VGA 9 
PC3270 10 
PC98 11 (PC-9801 の み ) 
PC98GRCG 12 (PC-9801 の み ) 
PC98EGC 13 (PC-9801 の み ) 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 
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※* grg が Ode は 、 初期 グラ フィ ックス モー ド を 示す 整数 で す (た だ し , 

* g7opgrzyer が DETECT に 等 し い 場合 に は , * grgp/yzoge は initgraph 
に よっ て , 検出 され た ドラ イ バ に お いて 最も 高い 解像度 が 得 ら れる モー ド 
に セッ ト さ れ ま す )。* gygpzode に は , graphics.h で 定義 8 され て いる 以下 
の よう な 列挙 型 grgpAics 7zodes の 定数 を 与え を る こと が で きま す 。 


ドラ イ バ gzgp/cs zzodes 値 横 ※ 縦 " パレ ッ ト ペー ジ 


PC98 PC98C8 0 640x400 8 色 
PC98C16 1 640X400 16 色 
PC98GRCG PC98C8 0 640x400 8 色 
PC98C16 1 640X400 16 色 
PC98EGC PC98C8 0 640x400 8 色 り 
PC98C16 1 640x400 16 色 2 
CGA CGACO 0 320x200 CO 1 
CGAC1 1 320x200 C1 1 
CGAC2 2 320x200 C2 和 
CGAC3 3 320x200 3 1 
CGAHI 4 640X200 2 色 1 
MCGA MCGACO 0 320x200 CO 1 
MCGAC1 1 320x200 Cl 1 
MCGAC2 2 320x200 C2 1 
MCGAC3 3 320x200 C3 1 
MCGAMED 4 640x200 2 色 1 
MCGAHI 5 640x480 2 色 1 
EGA EGALO 0 640x200 16 色 4 
EGAHI 1 640x350 16 色 2 
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EGA64 EGA64LO 640 メ 200 16 色 1 
EGA64HI 1 640X350 4 色 1 


ら 


EGAMONO EGAMONOHI 3 640X350 2 色 1* 
EGAMONOHI 3 640X350 2 色 2 ネネ 


HERC HERCMONOHI 0 720X348 2 色 2 
ATT400 ATT400CO 0 320X200 CO 1 
ATT400C1 1 320x200 C1 1 
ATT400C2 2 320X200 C2 1 
ATT400C3 3 320X200 C3 1 
ATT400MED 4 640X200 2 色 1 
ATT400HI 5 640※400 2 色 1 
VGA VGALO 0 640X200 16 色 2 
VGAMED 1 640X350 16 色 2 
VGAHI 2 640X480 16 色 0 
PC3270 PC3270 0 720X350 2 色 1 
IBM8514 IBM8514HI 0 640X480 256 色 
IBM8514LO 1 1024X768 256 色 


* ま 64K EGA モノ カー ド 
*※※ 256K EGA モノ カー ド 
ーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


注意 : * grgpZ の iper と * gygpzode に は 、 上 の 表 の 中 か ら 有 効 を 値 を 指 


定 し な けれ ば な り ま せん 。 そ うし な いと 期待 通り の 結果 が 得 ら れ な いこ と 
が あり ます 。 唯 一 の 例外 は * gygpg の ner ニ DETECT の 場合 で す 。 
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戻り 値 


可 搬性 


570 


上 の 表 中 の CO. C1.C2 お よび C3 は , CGA (お よび その 互換 ) シス テム で 
使用 で きる 4 つの 定義 済み の 4 色 の パレ ッ ト を 参照 し て いま す 。 こ れ ら の バ 
レッ ト で は バッ ク グ ラウ ンド カラ ー (項目 殺 ) の み が 指 定 可能 で , 他 の カ 
ラー は 固定 で す 。 こ の 点 の 詳細 に つい て は , ユー ザー ズ ガ イド 第 8 章 の 
「IBM PC CGA で の カラ ー 制 御 」 の 節 で 述べ られ て いま す が , 次 の 表 に 
まとめ だ け を 示し ます 。 


カラ ー 番 号 (ビク セル 値 ) に 割り 当て られ て いる 定数 


パレット 番号 1 2 3 
0 CGA LIGHTGREEN CGA LIGHTRED  CGA YELLOW 
1 CGA LIGHTCYAN OGAUGHIMAGENTA CGA WHITE 
2 CGA GREEN CGA RED CGA BROWN 
3 CGA CYAN CGA MAGENTA  CGA LIGHTGRAY 


initgraph を 呼び 出す と , * grgpZg の ver は カレ ント グラ フィ ックス ドラ イ 
に, ※ g7gPzzodg は カレ ント グラ フィ ックス モー ド に セッ ト さ れ ま す 。 


initgraph は , 常に 内 部 エラ ー コ ー ド を セッ ト し ます 。 成功 し た 場合 , エラ 
ー コ ー ド に は 0 が セッ ト さ れ ま す 。 エ ラー が 発生 し た 場合 は 、* grgpZ の 7ye/ 
は -2, -3, -4。 ある い は -5 に セッ ト され , graphresult も 同じ 値 を 返し ま 
す 。 各 値 は 次 の よう な 意味 を 持ち ます 。 


-2 グラ フィ ックス カー ド が 検出 で き な い 

-3 ドラ イ バ フ ァイル を 検出 で き な い 

-4 ドラ イ バ が 正しく な い 

~5 ドラ イ バ を ロー ド す る た め の メ モリ が 足り な い 


initgraph は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 


作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アダ 
プ タ を 備え て いな けれ ば な り ませ ん )。 
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関連 項目 


closegraph, detectgraph、 getdefaultpalette, getdrivername, 


getmoderange, graphdefaults、 graphgetmem, graphresult, 


installuserdriver、 registerbgidriver、 registerbgifont, 


restorecrtmode、 setgraphbufsize, setgraphmode 


1nc1ude <graphics.h> 
ず #Hnclude <stdio.h> 
ま #1nclude <conio.h> 
#1nclude <process.h> 


main() 


( 


1nt g_driver, g_mode, g_errori 
detectgraph(&g_driver, &g_mode): 
1E (g_driver < 0) 
0 
PrintE("No graphics hardware detected In): 
exit(1)j 
} 


PrintE("Detected graphics dciver #Xd。 mode #Zdwn'。 
g_driver, g_mode): 

getch( ) : 
1f (g_mode -= EGAHT) 

/* override mode 1f EGA detected */ 

8_mode = EGALOi 
1nitgraph(&g_driver。 &g mode, "" 
g_error = graphresu1t(): 


1f (g_error < 0) 
6 


Printf("1nitgraph errori Zs.\n" grapherrormeg(g_error) ): 


exit(1): 
} 


bar(0, 0, getmaxx( ) /2。 getmaxy( ) ) : 


getch(): 
c1osegraph(): 
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installuserdriver 


形式 


プロ ト タ イ プ 


解脱 


572 


BGI デバ イス ドラ イ バ テ ー ブ プル に 、 サ ー ド バー ティ 提供 の デバ イス ドラ イ 
バ を イン スト ー ル し ます 。 


#include <graphics.h> 
int far installuserdriver(char far * zgzne, int huge (* ge/ec7) (void) ) : 


graphics.h 


installuserdriver を 使用 する と , サー ド バ ー テ ィ 供 給 の デバ イス ドラ イ バ 
を , BGI の 内 部 テー ブル に 追加 する こと が で きま す 。 引 数 ge は 新しい 
デバ イス ドラ イ バ フ ァイル (. BGI) の 名 前 で す 。 引 数 efec' は オプ ショ ン 
で , 新しい ドラ イ バ に つい て くる 場合 が ある 自動 検出 関数 を 指す ポイ ンタ 
で す 。 こ の 自動 検出 関数 は 引数 を 持た ず , 関 数値 と し て 整数 を 返し ます 。 

この サー ド パ ペー ティ 供給 ドラ イ バ の 使う 方 法 は 2 つ あ り ま す 。 た と えば , い 
ま Spiffy Graphics Array(SGA) と いう 新しい グラ フィ ッ ク ポ ー ド を 購入 
し , SGA の 製造 元 か ら BGI デバ イス ドラ イ バ (SGA.BGI) も 供給 され た 
と し まし ょ う 。 こ の ドラ イ バ を 使う 最も 簡単 な 方 法 は 、 まず installuser- 
driver を 呼び 出し て これ を イン スト ー ル し , その 戻り 値 (割り 当て られ た 
ドラ イ バ 番 号 ) を 直接 initgraph に 渡す と いう も の で す 。 

も う 1 つ は , より 一 般 的 で , initgraph に よっ て ハー ドウ ェ ア 検 出 ロジ ッ ク 
の 一 部 と し て 呼び 出さ れる 自動 検出 関数 (お そら < SGA の 供給 元 は この 
自動 検出 関数 を つけ て くる は ず で す ) を リン ク す る と いう 方 法 で す 。 ドラ 
イ バ を Gnstalluserdriver を 呼び 出し て ) イン スト ー ル する 際 に , デバ イ 
ス ド ラ イ バ フ ァイル の 名 前 と と も に この 関数 の アド レス を 引数 と し て 渡し 
ます 。 
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戻り 値 


可 搬 性 


関連 項目 


デバ イス ドラ イ バ フ ァイル 名 と SGA 自動 検出 関数 を イン スト ー ル し た 後 
は ,initgraph を 呼び 出し て 通常 の 自動 検出 プロ セス を 行なわ せま す 。jnit- 
graph は 組み 込み の 自動 検出 関数 (detectgraph) を 呼び 出す 前 に , SGA 
自動 検出 関数 を 呼び 出し ます 。 SGA 自動 検出 関数 が SGA ハー ドウ ェ ア を 
見 つけ られ な か っ た 場合 は -11 (grError) を 返し , initgraph は 引き 続い て 
通常 の ハー ドウ ェ ア 検 出 ロジ ッ ク を 呼び 出し ます ( 他 に も サー ド バ パー ティ 
提供 の 自動 検出 関数 が 存在 する 場合 は , それ ら も イン スト ー ル され た 順 で 
呼ば れ ま す ) 。 自動 検出 関数 は SGA が 存在 する と 認識 し た 場合 負 で な い 
モー ド 番 号 を 返し initgraph は その 値 を 用 いて SGA.BGI を 見 つけ て ロ 
ー ド し , ハー ドウ ェ ア を 自動 検出 関数 が 推奨 する デフ ォ ル ト の グラ フィ ッ 
クス モー ド に し て , 最後 に 制御 を ユー ザ プ ロ グラ ム に 戻し ます 。 

一 度 に 10 個 まで の ドラ イ バ を イン スト ー ル する こと が で きま す 。 


installuserdriver に よっ て 返さ れる 値 は 、initgraph が 新しく イン スト ー 
ル さ れ た ドラ イ バ を 選択 きせ る た め に 渡す ドラ イ バ 番 号 で す 。 


installuserdriver は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で 
の み 動 作 し ます (IBM PC て で は, サポ ー ト する グラ フィ ックス ディ スプ レ 


イア ダ プ タ を 備え て いな けれ ば な り ま せん )。 


initgraph、 registerbgidriver 
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例 す お 1nc1ude <stdio.h> 
#1nclude <std1ib.h> 
す #1nc1ude <graphice.h> 


1nt Driver, Mode: 
1nt huge detectSGA(void) /* 自動 検出 ロジ ッ ク */ 
6 

1nt found,。 defau1tmodei 


/* 必要 な ハー ドウ ェ ア を 検出 する 
found = ーー */ 


1f (Ifound)  /* 見 つか ら な けれ ば エラ ー を 返す */ 
Freturn (&rError)i 


/* デフ ォ ル ト の グラ フィ ックス モー ド を 決定 する 
defau1tmode = */ 


return (defau1tmode ) : 
) 
main() 
6 
Driver = instal1luserdriver("SGA" 。 detectSGA) : 
1f ( grOk != graphresu1t() ) て /* テー ブル が いっ ぱい ? */ 
Printf("Error 1neta11ing user driver SGA.\n')』 
exit(1)j 
8) 


Driver = DETECTi /* 自動 検出 を 行なう */ 
1nitgraph(&Driver, &Mode, *""): /* 検出 を 無効 に する */ 


1E ( grOk != graphresu1t() ) exit(1): 
outtext(*User Tnsta11ed Drivers Supported* ) : 


getchar(): 
c1osegraph( ) 
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installuserfont 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


BGI シス テム に は 組み 込ま れ て いな い フ ォ ン ト フ ァイル (.CHR) を ロー ド 
し ます 。 


#include <graphics.h> 
int far installuserfont (char far * Zg7ze) ・ 


graphics.h 


ヵ g746 は 。 ス トロ ー ク フォ ント を 含む フォ ント ファ イル へ の パス 名 で す 。 一 
度 に 20 個 まで の フォ ント を イン スト ー ル する こと が で きま す 。 


installuserfont は 、settextstyle が 対応 する フォ ント を 選べ る よう に 渡す 
フォ ント ID 番号 を 返し ます 。 内 部 フォ ント テー ブル が いっ ぱい に な っ て 
いる 場合 は 、 -11 (grError) を 返し ます 。 


installuserfont は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
みろ 動作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ 


アダ プ タ を 備え て いな けれ ば な り ま せん )。 


settextstyle 
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Hine 

機能 2 点 を 結ぶ 直線 を 描き ます 。 

形式 #include <graphics.h> 
void far lineGnt x7。 int ア 7, int x2。int ア 2) : 

プロ ト タ イ プ graphics.h 

解脱 lime は , カレ ント カラ ー, ライ ンス タイ ル お よび ライ ン 幅 を 用 いて , カレ 
ント 位置 (CP) を 変更 せ ず に , 指定 され た 2 点 (xy/) と (x2.y2) を 結ぶ 
直線 を 描き ます 。 現 在 位置 (CP) は 更新 され ませ ん 。 

戻り 値 あり ませ ん 。 

可 搬性 lime は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 し ま 
す (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ プ タ を 
備え を て いな けれ ば な り ま せん )。 

関連 項目 linerel, lineto, setcolor, setlinestyle, setwritemode 

576 
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Hinerel 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


現在 位置 (CP) か ら 相 対 距 離 で 直線 を 描き ます 。 


#include <graphics.h> 
void far linerel(int が 、int の ) : 


graphics.h 


limerel は 、CP か ら , CP と の 相対 距離 (の: の み ) で ある 点 へ の 直線 を 描き 
ます 。CP は (の) だ け 移 動 し ます 。 


あり ませ ん 。 
linerel は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 し 
ます (IBM PC て で は, サポ ー ト する グラ フィ ックス ディ スプ レイ アダ プ タ 


を 備え て いな けれ ば な り ま せん )。 


line、lineto、setcolor、setlinestyle、 setwritemode 
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Hineto 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


578 


CP から (xyy) へ の 直線 を 描き ます 。 


#include <graphics.h> 


void far lineto(int x。int ) : 

graphics.h 

lineto は 、CP か ら (x ァ ) へ の 直線 を 描き , CP を (xy) に 動か し ます 。 
あり ませ ん 。 

lineto は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 し 
ます (BM PC で は 、 サ ポー ト す る グラ フィ ックス ディ スプ レイ アダ プ タ 


を 備え て いな けれ ば な り ま せん )。 


line, linerel、 setcolor, setlinestyle、 setvisualpage, setwritemode 
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moverel 


機能 現在 位置 (CP) を 相対 距離 で 動か し ます 。 


形式 #include <graphics.h> 
void far moverel(Gint の が int の ) : 


解説 moverel は , 現在 位置 (CP) を ェ 方 向 に み , 方向 に の 移動 し ます 。 
戻り 値 あり ませ ん 。 
可 搬性 moverel は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 


し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ プ 
タ を 備え そ て いな けれ ば な り ま せん )。 


関連 項目 moveto 
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moveto 


機能 現在 位置 (CP) を x) に 移動 し ます 。 


形式 #include <graphics.h> 


void far moveto(int *。int y) : 


プロ ト タ イ プ graphics.h 


解説 moveto は 、 現在 位置 (CP) を 与え られ た 位置 (x.y) に 移動 し ます 。 
戻り 値 あり ませ ん 。 
可 搬性 moveto は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 


し ます (HBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アタ プ 
クタ を 備え て いな けれ ば な り ま せん )。 


関連 項目 moverel 


580 第 2 章 Turbo C ラ イプ ラリ 


outtext 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


ビュ ー ポ ー ト 内 に 文字 列 を 表示 し ます 。 


#include <graphics.h> 
void far outtext(char far * 7exS の 72) : 


graphics.h 


outtext は 、 ビ ュー ポー ト 内 て 現在 設定 され て いる 位置 合わ せ , フォ ント , 
方 向 . 大 き さ を 使用 し て 文字 列 を 表示 し ます 。 

outtext は 、 与 えら れ た 文字 列 7ex/s/g を CP に 表示 し ます 。 テ キス ト の 
水平 方 向 の 桁 揃え の 設定 が LEFT _TEXT で, また テキ スト の 方 向 が 
HORIZ_DIR の 場合 。CP の 座標 は textwidth (7exszzg) だ け 増 加 し ま 
す 。 そ う で な い 場 合 は CP は 変化 し ませ ん 。 

何 種 類 ち も フォ ント を 用 いる 場合 、 コ ー ド の 互換 性 を 保つ た め に は 、 関数 
textwidth、textheight を 用 いて 文字 列 の 大 き さ を 決定 し て くだ きい 。 


注意 : outtext を 使っ て デフ ォ ル ト フ ォ ン ト て 文字 列 を 書く 場合 、 カ レン 
トビ ュー ポー ト の 外 へ は みだし て し まう 部 分 は 出力 され ませ ん 。 


注意 : outtext は 、 グ ラフ ィ ッ クス モー ド で の み 使 用 で きま す 。 テ キス トモ 
ー ド で は 使用 で きま せん 。 


あり ませ ん 。 
outtext は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動作 
し ます (1BM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アタ プ 


タ を 備え て いな けれ ば な り ませ ん )。 


gettextsettings, outtextxy、 settextjustify、 settextstyle, 
textheight、 textwidth 
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outtextxy 


機能 


形式 


プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 


582 


指定 し た 位置 に 文字 列 を 表示 し ます 。 


#include <graphics.h> 


void far outtextxy(int *。 int 、char far * 7ex が sg) ・ 

graphics.h 

outtextxy は 、 ビュ ー ポ ー ト 内 て 現在 設定 され て いる 位置 合わ せ ,、 フォ ン 
ト , 方 向 , 大 き さ を 使用 し て , 文字 列 を 与え られ た 位置 (xy) に 表示 し ま 
す 。 

何 種 類 も フォ ント を 用 いる 場合 、 コ ー ド の 互換 性 を 保つ た め に は , 関数 


textwidth、textheight を 用 いて 文字 列 の 大 き さ を 決定 し て くだ さい 。 


注意 : outtextxy を 使っ て デフ ォ ル ト フ ォ ン ト て 文字 列 を 書く 場合 . カレ 
ント ビ ピュー ポー ト の 外 へ は みだし て し まう 部 分 は 出力 され ませ ん 。 


注意 : outtextxy は , グラ フィ ックス モー ド で の み 使 用 で きま す 。 テ キス ト 
モー ド で は 使用 で きま せん 。 


あり ませ ん 。 
outtextxy は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ 


プ タ を 備え て いな けれ ば な り ま せん )。 


gettextsettings、 outtext. textheight, textwidth 
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ニー 
pieslice 


機能 バイ スラ イス (扇形 ) を 描い て , その 中 を フィ ル し ます 。 


形式 #include <graphics.h> 


void far pieslice (int *、int y。 int srgzge、 int ezggzg/e, int 7ggjzs) : 
プロ ト タ イ プ graphics.h 


解説 pieslice は , 中 心 が (x,。 ゅ ), 半径 が 7ggis の 扇形 を 描い て , その 中 を フィ 
ル し ます 。 扇形 の 角度 は sgzge か ら ezggzge まで で す 。 扇 形 の 輪郭 を カ 
レン トド ロウ カラ ー で 描き 、 カレ ント フィ ル バ パタ ー ン と フィ ルカ ラー で 中 
を フィ ル し ます 。 
pieslice の 角度 は , 反 時 計 ま わり で , 0 度 が 時 計 で 3 時 の 方 向 , 90 度 が 12 時 の 
方 向 で す 。 


注意 [IBM PC] : CGCA の ハイ レゾ リュ ーション モー ド , ある い は モノ クロ 
グラ フィ ックス アダ プ タ を 使用 し て いる 場合 , この マニ ュ ア ル に ある サン 
プル プロ グラ ム は 期待 通り に 動か な いこ と が あり ます 。CGA の ハイ レゾ リ 
ュー ショ ン モ ー ド また は モク ロア ダ プ タ を 使っ て いる 場合 は , フィ ルカ ラ 
ーー あるいは ドロ ウ カ ラー を セッ ト す る 関数 (setcolor, setfillstyle, set- 
Himestyle な ど ) に は , シン ポリ ッ ク 定 数 を 使わ ず に , 値 1 を 渡す よう に し て 
くだ さい 。are 関数 の 例 2 で ,.CGA ある い は モノ クロ アダ プ タ 上 で pieslice 
を どの よう に 使う か を 示し て いま す 。 


戻り 値 あり ませ ん 。 
可 搬性 pieslice は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の みろ 動作 
し ます (1BM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アタ プ 


タ を 備え て いな けれ ば な り ま せん )。 


関連 項目 fillellipse, graphresult、 sector, setfillstyle 


グラ フィ ックス 関数 リフ ァ レ ンス 583 


例 arc を 参照 し て くだ さい 。 
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= ミー ニー ニー ニニ ーーーーー ニ ーー ニニ ーー ニニ ーー ュ 


putimage 
機能 ビッ トイ メー ジ を 画面 上 に 出力 し ます 。 
形式 #include <graphics.h> 
void far putimage(int 77。int op、 yo 72/ ※ が の gp、 int op) : 
プロ ト タ イ プ graphicsh 
解説 putimage は , getimage に よっ て 以前 に セー プ ミ され た ビッ トイ メー ジ を 画 


面 上 に 復元 し ます 。 イ メー ジ の 左上 隅 は (7,/op) に 置か れ ま す 。 gp 
は , ビッ トイ メー ジ が 格納 され て いる メモリ 内 の 領域 を 指し ます 。 
引数 @ は , 画面 上 の ピク セル の カラ ー の 計算 で 行なわ れる 演算 の 種類 を 
指定 し ます 。 こ の 演算 は 画面 上 に 既に ある ビク セル と それ に 対応 する メモ 
リ 内 の ビク セル に 基づい て 行わ れ ま す 。 

graphics.h で 定義 きれ て いる pyzgge gpy テー ブル に これ ら の 演算 の 名 
前 が 与え られ て いま す 。 


ーーーーーーーーーーーーーーーーーーーーーーー、、 
名 前 値 機能 説明 


COPY PUT 0 ュ ピ ー 
XOR_PUT 1 排他 的 論理 和 
OR_ PUT 2 論理 和 

AND PUT 3 論理 積 

NOT PUT 4 ソー ス の 逆 コ ビー 


COPY_PUT は 、 ソー スピ ビッ トマ ッ プ イメ ー ジ を 画面 上 に 単に コビー し ま 
す 。 

XOR_PUT は . ソー スイ メー ジ と 画面 上 の イメ ー ジ と の XOR を と り ま 
す 。 

OR_PUT は , ソー スイ メー ジ と 画面 上 の イメ ー ジ の OR を と り ま す 。 


グラ フィ ックス 関数 リフ ァ レ ンス 585 


戻り 値 


可 搬 性 


関連 項目 


例 


586 


以下 同様 で す 。 

あり ませ ん 。 

putimage は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は 、 サ ポー ト す る グラ フィ ックス ディ スプ レイ アダ 
プ タ を 備え て いな けれ ば な り ませ ん )。 


getimage,、 imagesize、 putpixel、 setyisualpage 


getimage を 参照 し て くだ さい 。 
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putpixel 


機能 指定 され た 点 の ビク セル を プロ ッ ト し ます 。 


形式 #include <graphics.h> 
void far putpixel(int *。int 了 。int co/oy) : 


プロ ト タ イ プ graphics.h 


解説 putpixel は color て 定義 され る カラ ー で (x ゅ ) に 点 を 描き ます 。 
戻り 値 あり ませ ん 。 
可 搬性 putpixel は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 


し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ プ 
タ を 備え て いな けれ ば な り ま せん )。 


関連 項目 getpixel、 putimage 
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rectangle 


機能 長方形 を 描き ます 。 


形式 #include <graphics.h> 
void far rectangle(int 77。 int 7op, int 7g が 7。 int の o7/o7) : 


プロ ト タ イ プ graphics.h 


解説 rectangle は 、 カ レン トラ イン スタ イル , ライ ン 幅 , カラ ー を 使用 し て 長 方 
形 を 描き ます 。 
(/e77.79p) は 長方形 の 左上 隅 を , (7ig77,o7/o7) は 右 下 隅 を 指定 し ます 。 


戻り 値 あり ませ ん 。 

可 搬性 rectangle は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の みろ 動 
作 し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ 
プ タ を 備え て いな けれ ば な り ま せん) 。 


関連 項目 bar, bar3d、 setcolor, setlinestyle 


例 nt Hi 
for (is0i <10: i++) 
rectang1e(20-2*1 。 20-2*1 10*(1+2 ) ,10*(1+2) ) : 
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ーーー 
registerbgidriver 


機能 ユー ザ が ロー ド し た , ある い は リン ク さ れ て いる グラ フィ ックス ドラ イ バ 
コー ド を グラ フィ ックス シス テム に 登録 し ます 。 


形式 #include <graphics.h> 
int registerbgidriver(void (* み ive/) (void) ) : 


プロ ト タ イ プ graphics.h 


解説 registerbgidriver に よっ て 、 ユー ザ が ドラ イ バ フ ァイル を ロー ド し て , そ 
の ドラ イ バ を 登録 する こと が で きま す 。 ド ライ バ の メモ リ 位 置 が register- 
bgidriver に 渡さ れ て いれ ば 、initgraph は その 登録 きま れ た ドラ イ バ を 使用 
し ます 。 ユ ー ザ が 登録 する ドラ イ バ は , ディ スク か ら ヒ ー プ 上 に ロー N ま 
る か , (BINOBJ.EXE を 使っ て ).OBJ ファ イル に 変換 し て .EXE ファ イル 
に リン ク す る こと が で きま す 。 
registerbgidriver を 呼び 出す と , グラ フィ ックス シス テム に リン ク さ れる 
べき ドラ イ バ が 存在 する こと を 知ら せる こと に な り ま す 。 こ の ルー チン は 。 
その ドラ イ バ に 対す る リン ク さ れる べき コー ド を チェ ッ ク し , コー ド が 正 
し い ゅ 場合 は 内 部 テー ブル に 登録 し ます 。 リ ンク され る ドラ イ バ に 関し て は , 
ユー ザー ズ ガ イド 付録 C の 「BGIOBJ」 の 節 で 詳し く 説 明 さ れ て いま す 。 
registerbgidriver の 呼び 出し で リン ク さ れる ドラ イ バ の 名 前 を 使用 する 
と , コン パイ ラ (お よび リン カ ) に , その パプ リッ ク 名 で オプ ジェ クト フ 
ァイル を リン ク す る よう 指示 する こと に な り ま す 。 


戻り 値 registerbgidriver は 、 指定 され た ドラ イ バ が 正しく な い 場 合 は 負 の グラ 
フィ ックス エラ ー コ ー ド を 返し ます 。 そ う で な い 場 合 は 、 内 部 ドラ イ バ 番 
号 を 返し ます 。 


ユー ザ 供給 の ドラ イ バ を 登録 する 場合 は 、registerbgidriver が 返し た 値 
を 、 使用 する ドラ イ バ 番 号 と し て initgraph に 渡 き な けれ ば な り ませ ん 。 
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可 鬼 性 


関連 項目 


590 


registerbgidriver は PC-9801 シリ ー ズ (また は IBM PC と その 互換 機 ) 
で の みろ 動作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ 
レイ アダ プ タ を 備え て いな けれ ば な り ませ ん )。 


graphresult, initgraph,、 installuserdriver、registerbgifont 


/* PC-9801 EGC ド ライ バ を 登録 */ 
1f (regsterbg1drtver(PC98EGC_driver) <0O) exit(1): 


第 2 車 Turbo C ラ イプ ラリ 


registerbgifont 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


リン ク さ れる スト ロー ク フ ォ ント コー ド を 登録 し ます 。 


#include <graphics.h> 
int registerbgifont (void (* /oz) (void) ) : 


graphics.h 


registerbgifont の 呼び 出し は , 6z に よっ て 指 さ れ る フォ ント が リン ク 
時 に 取り 込ま れ て いる こと を グラ フィ ックス シス テム に 知ら せま す 。 
この ルー チン は , 指定 され た フォ ント に 対す る リン ク さ れ た コー ド を チェ 
ッ ク し , コー ド が 正しい 場合 は その 内 部 テー ブル に 登録 し ます 。 リ ンク さ 
れる フォ ント に 関し て は , ユー ザー ズ ガ イド 付録 C の 「BGIOBJ」 の 節 で 
詳し く 説 明 さ れ て いま す 。 

registerbgifont を 呼び 出す と き に リン ク さ れる フォ ント の 名 前 を 使用 す 
る と ,。 コン パイ ラ (ある い は リン カ ) に , その パプ リッ ク 名 で オプ ジェ ク 
ト フ ァイル を リン ク す る よう 指示 する こと に な り ま す 。 

ユー ザ 供 給 の フォ ント を 登録 する 場合 に は , registerbgifont が 返し た 値 
を , settextstyle に 使用 する フォ ント 番号 と し て 渡さ な けれ ば な り ま せん 。 


registerbgifont は , 指定 され た フォ ント が 正しく な い 場 合 は , 負 の グラ フ 
ィ ッ クス エラ ー コ ー ド を 返し ます 。 そ う で な い 場 合 は , 登録 し た フォ ント 
の フォ ント 番号 を 返し ます 。 


registerbgifont は PC-9801 シリ ー ズ (また は IBM PC と その 互換 機 ) で 
の みろ 動作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レ 
イア ダ プ タ を 備え て いな けれ ば な り ま せん )。 


graphresult, initgraph, installuserdriver, registerbgidriver, 
settextstyle 


/* ゴシック フォ ント を 登録 +/ 
1f (reg1eterbg1font(gothic_Eont) != GOTHTC_PONT) exlt(1): 
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restorecrtmode 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


592 


画面 モー ド を , initgraph 実行 前 の モー ド に 戻し ます 。 


#include <graphics.h> 
void far restorecrtmode (void) : 


graphics.h 


restorecrtmode は , initgraph に よっ て 検出 され た 元 の 画面 モー ド を 回 復 
し ます 。 

restorecrtmode は 、 setgraphmode と 組み 合わ せ て , テキ スト モー ド と グ 
ラフ ィ ッ クモ ー ド の 間 を 行き 来 す る た め に 使用 する こと が で きま す 。 text- 
mode を 同じ 目的 で 使用 する こと は で きま せん 。 textmode は , 画面 が テキ 
スト モー ド の と き に の み 使 用 で き , 他 の テキ スト モー ド に 切り 換え る と き 
に 使う こと が で きま す 。 


注意 : IBM PC で は , テキ スト 画面 と グラ フィ ックス 画面 を 同時 に 表示 す 
る こと が で き な い た め に こう し た 関数 が 用 意 き れ て いま す 。PC-9801 で は , 
同時 表示 が 可能 な の で , restorecrtmode お よび setgraphmode を 使わ ず 
に , グラ フィ ックス 出力 と テキ スト 出力 を 混在 させ て , その 両方 を 画面 に 
表示 させ る こと が で きま す 。restorecrtmode お よび setgraphmode は , ど 
ちら も 画面 全体 を クリ ア し て 初期 化す る の で , PC-9801 で これ ら を 使う 場 
合 に は , テキ スト と グラ フィ ックス を 同時 に 表示 する こと は で きま せん 。 


あり ませ ん 。 
restorecrtmode は PC-9801 シリ ー ズ (また は IBM PC と その 互換 機 ) で 
の み 動 作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レ 


イア ダ プ タ を 備え て いな けれ ば な り ま せん )。 


getgraphmode、 initgraph, setgraphmode 
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Sector 

機能 頂 円 の 扇形 を 描い て 、 その 中 を フィ ル し ます 。 

形式 #include <graphics.h> 
void far sector(int *、int 了 、int szgzgfe。 int eg/e, 

int x7ggzs、 int yygg が sy) : 

プロ ト タ イ プ graphics.h 

解説 sector は , 中 心 を (*), 水平 お よび 垂直 方 向 の 半径 を それ ぞ れ xyggx 
Jegs と し 、 角度 が sgge か ら eggg/e ま で の 椿 円 の 扇形 を 描い て , そ 
の 中 を フィ ル し ます 。 選 形 の 輪郭 は カレ ント カラ ー で 描か れ , setfillstyle 
お よび setfillpatterm で セッ ト さ れ て いる バ パターン と カラ ー で フ ィ ル し ま 
す 。 
sector に 与え る 角度 は 、 反 時 計 回 り で, 3 時 の 位置 が 0, 12 時 の 位置 が 90" 
と な り ま す 。 
頂 円 の 扇形 を フィ ル し て いる と き に エラ ー が 起き た 場合 , graphresult は 
-6 (grNoScanMem) を 返し ます 。 

戻り 値 あり ませ ん 。 

可 搬 性 sector は PC-9801 シリ ー ズ (また は IBM PC と その 互換 機 ) で の み 動作 し 
ます QBM PC で は 、 サポート する グラ フィ ックス ディ スプ レイ アダ プ タ 
を 備え て いな けれ ば な り ま せん )。 

関連 項目 arc,、 circle、 ellipse、 getarccoords, getaspectratio, pieslice, 


setfillpattern, setfillstyle、 setgraphbufsize 
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setactivepage 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


594 


グラ フィ ックス 出力 を 行なう アク ティ プペ ー ジ を セッ ト し ます 。 


#include <graphics.h> 


void far setactivepage(int pge) : 


graphics.h 


setactivepage は 、 pgge を アク ティ ブ グ ラフ ィ ッ クス ペー ジ に セッ ト し ま 
す 。 これ 以降 , グラ フィ ックス 出力 は グラ フィ ックス ペー ジ pgge に 対し て 
行なわ れ ま す 。 

使用 し て いる シス テム が グラ フィ ックス ペー ジ を 何 枚 持っ て いる か に よっ 
て , アク ティ プ グ ラフ ィ ッ クス ペー ジ が 画面 に 見 えて いる 場合 と 見 えて い 
な い 場 合 が あり ます 。 


注意 


に ペー 


この 関数 は デバ イス を 直接 制御 する も の で , 現在 使用 中 の シス テム 
ジ が 何 ペ ー ジ 存在 する か は 得る こと が で きま せん 。PC-9801 で は , 初 
期 型 の PC-9801 と PC-9801U は グラ フィ ックス ペー ジ を 1 画面 し か 持っ 
て いま せん 。 他 の タイ プ は グラ フィ ックス ペー ジ を 2 枚 持っ て お り , 1 枚 目 
が 0 ペー ジ 。2 枚 目 が 1 ペー ジ に な り ま す 。 


あり ませ ん 。 

setactivepage は PC-9801 シリ ー ズ (また は IBM PC と その 互換 機 ) で の 
みろ 動作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ 
アダ プ タ を 備 そ て いな けれ ば な り ま せん )。 


setvisualpage 


c1eardevtce( ) : 


setvisualpage(0): /* 0 ベ ページ を ビジ ュ ア ル に */ 
setacttvepage(1) : /* ユ ペ ー ジ を 出力 用 に 使う */ 
bar(50, 50。 150, 150):  /* 1 ペー ジ に バー を 指 画 */ 
setvisualpage(1): /* 1 ユ ペ ー ジ を ビジ ュ ア ル に */ 
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ーー ニー ニー ニー ニテ ーー ニニ ーー ニー ーー ニー ニニ ーー 。 
setallpalette 


機能 すべ て の パレ ッ ト カ ラー を 指定 どおり に 変更 し ます 。 


形式 #include <graphics.h> 
void far setallpalette(struct palettetype far * pg/rze) : 


プロ ト タ イ プ graphics.h 


解説 setallpalette は , pg/eze が 指す palettetype 型 構造 体 の 内 容 に し た が っ 
て , カレ ント パレ ッ ト を 変更 し ます 。 
EGA/VGA の パレ ッ ト 中 の カラ ー は 、 setallpalette に よっ て 部 分 的 に ( あ 
る い は 全部 を ) 変更 する こと が で きま す 。 
setallpalette で 用 いら れる 定数 MAXCOLORS と palettetype 型 構造 体 
は , graphics.h の 中 で 次 の よう に 定義 る され て いま す 。 


すま define MAXCOLORS 15 


struct palettetype て 

unstgned char etzei 

signed char colors[MAXCOLORS + 1]j 
})j 
sze は 、 カ レン トグラフ ィ ッ クス ドラ イ バ と , カレ ン トグラフ ィ ッ クス モー 
ド で の , パレ ッ ト 中 の カラ ー 数 で す 。 
9s は 、 バレット 中 の 各 項 目 に 対応 する 実際 の カラ ー 番 号 を 要素 と する 
Se バイ ト の 配列 で す 。 coors の 要素 が -1 の 場合 は , その 項目 の パレット カ 
ラー は 変更 きれ ませ ん 。 setallpalette で 使わ れる 配列 co/ors の 要素 は , 
graphics.h の 中 で 定義 きれ て いる 以下 の シン ポリ ッ ク 定 数 で 表わす こと が 
で きま す 。 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


PC-9801 / CGA EGA / VGA 
名 前 値 名 前 値 
BLACK 0 EGA BLACK 0 
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戻り 値 


可 搬性 


関連 項目 


596 


BLUE 1 EGA_BLUE 1 
GREEN 2 EGA GREEN 2 
CYAN 3 EGA CYAN 3 
RED 4 EGA RED 4 
MAGENTA 5 EGA_ MAGENTA 5 
BROWN 6 EGA_ LIGHTGRAY 6 
LIGHTGRAY 7 EGA BROWN 20 
DARKGRAY 8 EGA_DARKGRAY 56 
LIGHTBLUE 9 EGA LIGHTBLUE 57 
LIGHTGREEN 10 EGA_LIGHTGREEN 58 
LIGHTCYAN 11 EGA_ LIGHTCYAN 59 
LIGHTRED 12 EGA LIGHTRED 60 
LGHTMAGENTA 13 EGA LIGHTMAGENTA 61 
YELLOW 14 EGA_ YELLOW 62 
WHITE 15 EGA_WHITE 63 


指定 で きる カラ ー は カレ ント グラ フィ ックス ドラ イ バ と グラ フィ ックス モ 
ー ド に 依存 し て いる こと に 注意 し て くだ さい 。 

パレ ッ ト を 変更 する と , 変化 は 即座 に 画面 に 反映 され ます 。 パ レッ ト の みか カ 
ラー が 変化 する た びに , 画面 上 で て そ の カラ ー が 表示 され て いる 部 分 は すべ 
て 新しい カラ ー に 変わ り ま す 。 


注意 : setallpalette は , IBM8514 ド ライ バ で は 使用 で きま せん 。 IBM8514 
で は setrgbpalette を 使っ て くだ さい 。 


あり ませ ん 。 

setallpalette に 正しく な い 入 力 を 与え る と 、 graphresult は -11 を 返し 、 カ 
レン トペ レット は 変更 きれ ませ ん 。 

setallpalette は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 
動作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ ア 


ダ プ タ を 備え て いな けれ ば な り ま せん ) 。 


getpalette, graphresult、 setbkcolor, setcolor, setpalette 
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setaspectratio 

機能 デフ ォ ル ト の アス ペク ト 比 補正 因子 を 変更 し ます 。 

形式 #include <graphics.h> 
void far setaspectratio (int xgyp、int ygp) : 

プロ ト タ イ プ graphics.h 

解説 setaspectratio は 、 グラ フィ ックス シス テム の デフ ォ ル ト の アス ペク ト 因 
子 を 変更 する た め に 使用 し ます 。 ア スペ クト 比 は ,、 グラ フィ ックス シス テ 
ム が 円 を 真 円 と し て 描く こと が で きる よう に する た め に 使用 され ます 。 画 
面 に 出力 し た 円 が 権 円 に な っ て し まう と すれ ば , モニ タ の ビク セル の 配置 
が 適切 で な いと 考え る こと が で きま す 。 こ の よう な 場合 , モニ タ を 配置 し 
な お し て ハー ド 的 に 補正 する こと が で きま す が , ソフ ト 的 に 
setaspectratio を 使っ て アス ペク ト 比 を 変更 し て 補正 する こと も 可能 で す 。 
現在 の アス ペク ト 比 は , getaspectratio の 呼び 出し に よっ て 得る こと が で 
きま す 。 

戻り 値 あり ませ ん 。 

可 搬性 setaspectratio は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
ろ 動 作 し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ 
アダ プ タ を 備え て いな けれ ば な り ませ ん )。 

関連 項目 circle. getaspectratio 
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setbkcolor 


機能 


形式 


プロ ト タ イ プ 
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バ パレット を 用 いて カレ ント バッ ク グ ラウ ンド カラ ー を セッ ト し ます 。 


#include <graphics.h> 
void far setbkcolor(int co/oy) : 


graphics.h 
setbkcolor は 、 バッ ク グ ラウ ンド を co/pr で 指定 され た カラ ー に セッ ト し 


ます 。 引数 coor に は , graphics.h で 定義 され て いる , 次 に 示す 名 前 ある い 
は 番号 を 使う こと が で きま す 。 


番号 名 前 番号 名 前 
0 BLACK 8 DARKGRAY 
1 BLUE 9 LIGHTBLUE 
2 GREEN 10 LIGHTGREEN 
3 CYAN 11 LIGHTCYAN 
4 RED 12 LIGHTRED 
5 MAGENTA 13 LIGHTMAGENTA 
6 BROWN 14 YELLOW 
7 LIGHTGRAY 15 WHITE 


注意 : PC-9801 の 8 色 モ ー ド (PC98C8) で も , 上 の 表 の すべ て の 名 前 ある い 
は 番号 を 指定 する こと は で きま す が , 実際 に 表示 され る 色 は 8 色 に な り ま 
す 。 8 色 モ ー ド の 場合 , 上 の 表 で 同じ 行 に 示さ れ て いる カラ ー は 同じ 意味 を 
持つ こと に な り ま す 。 
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戻り 値 


可 搬 性 
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た と えば , バッ ク グ ラウ ンド カラ ー を 青 に し た いと き に は , setbkcolor を 
次 の よう に 呼び 出し ます 。 


setbkco1or(BLUE) /* また は */ setbkcolor(1) 


CGA お よび EGA シス テム で は , setbkcolor は 、 パ レッ ト 中 の 最初 の 項目 
を 変更 する こと に よっ て バッ ク グ ラウ ンド カラ ー を 変更 し ます 。 


注意 : EGA また は VGA シス テム で setpalette ある い は setallpalette に 
よっ て パレ ッ ト カ ラー を 変更 する 場合 、 定 義 済み の シン ポリ ッ ク 定 数 は 正 
し い カ ラー を 示し て いな いこ と が あり ます 。 こ れ は , setbkcolor へ の パラ 
メー タ が , 特定 の カラ ー で は な く , カレ ント パレ ッ ト 中 の 項目 番号 を 示し 
て いる た めで す ( 渡 され た パラ メー タ が 0 で な けれ ば , バッ ク グ ラウ ンド カ 
ラー は 常に 黒 に セッ ト され ます ) 。 


あり ませ ん 。 
setbkcolor は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は 、 サ ポー ト す る グラ フィ ックス ディ スプ レイ アダ 


プ タ を 備え て いな けれ ば な り ま せん )。 


getbkcolor、 setallpalette、 setcolor、setpalette 
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setcolor 


機能 パレ ッ ト を 用 いて カレ ント ドロ ウ カ ラー を セッ ト し ます 。 


形式 #include <graphics.h> 


void far setcolor(int co/py) : 


プロ ト タ イ プ graphics.h 


解説 setcolor は 、 カ レン トド ロウ カラ ー を co/or に 設定 し ます 。co/or の 範囲 は 


0 か ら getmaxcolor まで で す 。 


ドロ ウ カ ラー と は 線 な ど を 描く と き に ピク セル に セッ ト さ れる 値 の こと 
で す 。 PC-9801 シ リー ズ お よび IBM PC の EGA で は , 次 の 表 に 示す ドロ ウ 


カラ ー を 使う こと が で きま す 。 


番号 名 前 番号 名 前 
0 BLACK 8 DARKGRAY 
1 BLUE 9 LIGHTBLUE 
2 GREEN 10 LIGHTGREEN 
3 CYAN 11 LIGHTCYAN 
4 RED 12 LIGHTRED 
5 MAGENTA 13 LIGHTMAGENTA 
6 BROWN 14 YELLOW 
7 LIGHTGRAY 15 WHITE 


ドロ ウ カ ラー を 選択 する に は , その カラ ー 番 号 あ る い は 対応 する シン ポリ 
ッ ク 名 を setcolor に 渡し て 呼び 出し ます 。 た と えば ぼ ば PC-9801 で ドロ ウ カ ラ 
ー に 紫 を 選択 し た いと れ ば , setcolor(MAGENTA), ある い は setcolor 


(5) と し ます 。 
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注意 : PC-9801 の 8 色 モ ー ド (PC98C8) で も , 上 の 表 の すべ て の 名 前 ある い 
は 番号 を 指定 する こと は で きま す が , 実際 に 表示 され る 色 は 8 色 に な り ま 
す 。 8 色 モ ー ド の 場合 . 上 の 表 で 同じ 行 に 示さ れ て いる カラ ー は 同じ 意味 を 
持つ こと に な り ま す 。 


CGA シス テム で は 以下 の カラ ー が 指定 可能 で す 。 


パレット カラ ー 番 号 (ビク セル 値 ) に 割り 当て られ て いる 定数 


番号 1 2 3 
0  CGALGHTGREEN CGALIGHTRED CGCAYELLOW 
1 。CGALIGHTCYAN CCALGHTMAGENTA CGA WHITE 
2 CGCAGREEN CGA RED CGA BROWN 
3  CGA CYAN CGA_MAGENTA CCGA_LIGHTGRAY 


た と えば CGA0 モ ー ド で は , パレ ッ ト に は , バッ ク グ ラウ ンド カラ ー, 明 
る い 緑 , 明る い 赤 , 黄色 の 4 色 が あり ます 。 こ の モー ド て 黄色 を 選択 し た い 
と すれ ば , setcolor(3), あ るい は setcolor(CGA_YELLOW) を 呼び 出し ま 
す 。 


あり ませ ん 。 
setcolor は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 作 
し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ タプ 


タ を 備え て いな けれ ば な り ま せん )。 


getcolor、 getmaxcolor、 setallpalette、 setbkcolor, setpalette 
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setfillpattern 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 
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ユー ザ 定 義 の フィ ル バ パタ ー ン を 定義 し ます 。 


#include <graphics.h> 


void far setfillpattern (char far * pgrzerz, int co/o) : 

graphics.h 

setfillpattern は , setfillstyle と 似 て いま す が , こ ちら は シス テム 定義 の バ 
ター ン で は な く , ユー ザ 定 義 の 8X8 パ ター ン を 設定 する た め に 使用 し ます 。 
gpg77er7 は 8 バイ ト 列 を 指す ポイ ンタ で す 。 各 バイ ト は パタ ー ン 中 の 8 ビク 

セル に 対応 し て いま す 。 バ ター ン 内 で 1 に 設定 され て いる ビッ ト に 対応 する 

ピク セル が プロ ッ ト さ れ ま す 。 

あり ませ ん 。 

setfillpatern は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 

動作 し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ ア 


ダ プ タ を 備え て いな けれ ば な り ま せん )。 


getfillpattern、 getfillsettings, setfillstyle 
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setfillstyle 


形式 


プロ ト タ イ プ 


フィ ル バ パタ ー ン と フィ ルカ ラー を セッ ト し ます 。 


#include <graphics.h> 
void far setfillstyle(int perz、 int co/or) ・ 


graphics.h 


setfillstyle は 、 カ レン ト フ ィ ル バ パターン と フィ ルカ ラー を 設定 し ます 。 ユ 
ー ザ 定義 の フィ ル バ パタ ー ン を 設定 する に は 、 setfillstyle に 12 (USER 
FILL) の pgrrer を 与え を る の で は な く 、 setfillpattern を 呼び 出し て くだ さ 
い 。 

graphics.h で 定義 され て いる 7 pgrern テー ブル は , シス テム 定義 フィ ル 
バタ ー ン の 名 前 と ユー ザ 定 義 パ ター ン の 指示 子 を 与え を て いま す 。 


名 前 値 機能 説明 
EMPTY FILL 0 バッ ク グ ラウ ンド カラ ー で フィ ル ( 中 空 ) 
SOLID_FILL 1 ベタ 人 塗り 
LINE FILL 2 横線 で フィ ル 
LTSLASH_FILL 3 ググ で フィ ル 
SLASH _FILL 4 ググ で フィ ル , 太線 
BKSLASH_FILL 5 へ ヽ ヽ で フィ ル , 太線 
LTBKSLASH _FILL 6 へ ヽ へ ヽ へ で フィ ル 
HATCH _FILL 7 淡い ハッ チ (格子 ) で フィ ル 
XHATCH _FILL 8 濃い クロ スハ ッ チ (斜め の 格子 ) で フィ ル 
INTERLEAVE FILL 9 イン ター リー プ 線 で フィ ル 
WIDE DOT FILL 10 すき 間 が 広い 点 で フィ ル 
CLOSE_DOT_FILL 11 すき 間 が 狭い 点 で フィ ル 
USER_FILL 12 ユー ザ 定 義 の フィ ル バ パタ ー ン 
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EMPTY FILL 以外 の も の は , カレ ント フィ ルカ ラー で フィ ル し ます 。 
EMPTY FILL は , カレ ント バッ ク グ ラウ ンド カラ ー を 用 いま す 。 
setfillstyle に 不適 当 な 値 が 渡さ れる と , graphresult は -11 (grError) を 
返し ,。 フィ ルター ン と フィ ルカ ラー は 変更 きれ ず 元 の まま に な り ま す 。 


あり ませ ん 。 
setfillstyle は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は 、 サポート す る グラ フィ ックス ディ スプ レイ アダ 


プ タ を 備え て いな けれ ば を なり ませ ん )。 


bar,、bar3d, fillpoly、floodfill、 getfillsettings, graphresult, 
pieslice、 sector, setfillpattern 
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setgraphbufsize 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


内 部 グラ フィ ックス パッ ファ の サイ ズ を 変更 し ます 。 


#include <graphics.h> 
unsigned far setgraphbufsize (unsigned が 7sze) : 


graphics.h 


グラ フィ ックス ルー チン の 中 に は (floodfil の よう に ) メモ リバ ッ フ ァ を 
用 いる も の が あり ます 。 こ の メモ リバ ッ フ ァ は initgraph が 呼ば れ た と き 
に 確保 きれ , closegraph が 呼ば れ た と き に 解放 ほれ ます 。 graphgetmem 
に よっ て 確保 まき れる バッ ファ サイ ズ の デフ ォ ル ト は 4096 バ イト で す 。 

この バッ ファ サイ ズ を 小さ くし た いと き ( メ モリ を 節約 する )、 あ る い は 大 
きく し た いと き (た と えば floodfill を 呼び 出し て エラ ー 値 -7、 すなわち フ 
ラッ ド フ ィ ル で メモ リ が 不足 し た 場合 ) に は この 関数 を 使う こと に な り ま 
す 。setgraphbufsize は 、initgraph に 、 graphgetmem を 呼ぶ 際 に 内 部 
バッ ファ と し て どれ だ け の メモ リ を 確保 すべ きか を つた えま す 。 


注意 : setgraphbufsize は 、initgraph より 前 に 呼び 出さ な けれ ば な り ま 
せん 。initgraph が 呼び 出さ れ た 後 で 行なわ れ た すべ て の setgraphbufs- 
ize の 呼び 出し は , 次 に closegraph が 呼び 出さ れる まで は 意味 を な し ませ 
ん 。 


setgraphbufsize は 内 部 バッ ファ の 以前 の サイ ズ を 返し ます 。 
setgraphbufsize は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で 
の みろ 動作 し ます (IBM PC で は 、 サ ポー ト す る グラ フィ ックス ディ スプ レ 


イア ダ プ タ を 備え て いな けれ ば な り ま せん )。 


closegraph、 graphfreemem. _graphgetmem、initgraph 
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例 1nt cbsizei 
cbslze = setgraphbufslze(1000)』 /* カレ ント サイ ズ を 得る */ 
setgraphbufs1ze(cbs1ze) /* 元 の サイ ズ に 戻す き / 
Printf("The graphics buffer 1s current1y Zd bytes.",。 cbeize)i 


606 第 2 章 Turbo C ラ イブ ラリ 


setgraphmode 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


シス テム を グラ フィ ッ ク モ ー ド に セッ ト し , テキ スト 画面 を クリ ア し ます 。 


#include <graphics.h> 
void far setgraphmode(int zzoge) : 


graphics.h 


setgraphmode は , initgraph で 設定 され る デフ ォ ル ト の モー ド と は 違っ 
た グラ フィ ックス モー ド を 選択 し ます 。 ode は カレ ント デバイス ドラ イ 
バ に 有効 な モー ド で な けれ ば な り ませ ん 。setgraphmode は 画面 を クリ ア 
し , すべ て の グラ フィ ックス 設定 を デフ ォ ル ト に セッ ト し ます (CP, パレ 
ッ ト 、 カラー, ビュー ポー ト な ど )。setgraphmode は restorecrtmode と 
と も に , テキ スト モー ド と グラ フィ ックス モー ド の 切り 替え に 使用 し ます 。 


注意 : IBM PC で は ,、 テキ スト 画面 と グラ フィ ックス 画面 を 同時 に 表示 す 
る こと が で き な い た め に こう し た 関数 が 用 意 き され て いま す 。PC-9801 で は , 
同時 表示 が 可能 な の で , restorecrtmode お よび setgraphmode を 使わ ず 
に , グラ フィ ックス 出力 と テキ スト 出力 を 混在 させ て , その 両方 を 画面 に 
表示 させ る こと が で きま す 。restorecrtmode お よび setgraphmode は , ど 
ちら も 画面 全体 を クリ ア し て 初期 化す る の で , PC-9801 で これ ら を 使う 場 
合 に は ,、 テキ スト と グラ フィ ックス を 同時 に 表示 する こと は で きま せん 。 


カレ ント デバ イス ドラ イ バ に 不適 当 な モー ド を setgraphmode に 与え た 
場合 、graphresult は -10(grInvalidMode) の 値 を 返し ます 。 


setgraphmode は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
みろ 動作 し ます (IBM PC で は . サポ ー ト する グラ フィ ックス ディ スプ レイ 
アダ プ タ を 備え て いな けれ ば な り ま せん )。 


getgraphmode, getmoderange、 graphresult, initgraph、 restorecrt- 
mode 
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ーー ニー ニー ニー ニー ニー ニニ ーー ニニ ニテ ニー = 
setlinestyle 


機能 カレ ント ライ ン 幅 と ライ ンス タイ ル を セッ ト し ます 。 


形式 #include <graphics.h> 


void far setlinestyle(int es を, unsigned zpg7erz。 int Ac ん zess) : 
プロ ト タ イ プ graphics.h 


解説 setlinestyle は 、line, lineto、rectangle, drawpoly な ど で 描か れる すべ 
て の ライ ンス タイ ル を 設定 し ます 。 
linesettingstype 構造 体 は 、graphics.h で 次 の よう に 定義 され て いま す 。 


struct 11nesettingstype { 
1nt 1inesty1ei 
unsigned upatterni 
1nt thickness: 

) 


es を は , それ 以降 に 描か れる ライ ン の スタ イル を 指定 し ます (た と え 


ば , 実線 点線 、 一 点 鎖線 、 破線)。 graphics.h で 定義 され て いる ze se 
テー ブル に は これ ら の 演算 子 の 名 前 が 与え を られ て いま す 。 


名 前 値 機能 
SOLID_ LINE 0 実線 
DOTTED LINE 1 点線 
CENTER_ LINE 2 一 点 鎖線 
DASHED LINE 3 破線 
USERBIT LINE 4 ユー ザ 定 義 の ライ ンス タイ ル 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


Wickzesy は 、 そ れ 以 降 に 描か れる 線 の 幅 が , 普通 か 太い か を 指定 する も の 
で す 。 
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名 前 値 機能 


NORM _WIDTH 1 1 ピク セル 幅 
THICK WIDTH3 3 ピク セル 幅 
ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


4 の 77ey2 は 、 が jesDe が USERBIT LINE(4) の と き に の み 適 用 する 16 ビ ッ 
トバ パターン で す 。 この 場合 , パターン ワ ー ド 内 の 1 の ビッ ト に 対応 する ライ 

ン 内 の ビク セル が ,。 カレ ント ドロ ウ カ ラー で 描か れ ま す 。 た と えば , 実線 

は OxFFFF の 4pgzerz( す べ て の ビク セル の 描画 ) に 対応 し , 破線 は 0x3333 

また は 0OxOFOF の pg7zeyz に 対応 し ます 。setlinestyle の 引数 espe が 

USERBIT_LINE(4) で な い 場合 も , pe は 与え を な けれ ば な り ま せん 
(無視 され ます が )。 


注意 : es を パラ メー タ は , 円 弧 。 円 周 , 棒 円 弧 , 円 周 に は 影響 を 与え 
ませ ん (扇形 と 檜 円 の 扇形 の 半径 に は 影響 を 与え ます )。 7Aickzess パラ メー 
タ は これ ら に 影響 し ます 。 


setlinestyle に 不適 当 な 値 が 渡さ きれ た 場合 , graphresult は -11 を 返し , カ 
レン トラ イン スタ イル は 変化 し ませ ん 。 


setlinestyle は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 
動作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ ア 
ダ プ タ を 備え て いな けれ ば な り ま せん )。 


bar3d、 getlinesettings、graphresult、line, linerel, Hineto、rectangle 
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setnewdriver (PC-9801 の み ) 


機能 


形式 


プロ ト タ イ プ 


解脱 
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デフ ォ ル ト 以 外 の グラ フィ ックス ドラ イ バ を 登録 し ます 。 


#include <graphics.h> 
int far setnewdriver("PC98", detect98) : 


graphics.h 
setnewdriver は 、 バ パー ジョ ン 1.5 の コー ド と の 互換 性 の た め に の み 用 意 き 


れ て いる も の で 内 部 で は 単に その まま の 引数 で installuserdriver を 呼び 
出す だ け で す 。 


バー ジョ ン 2.0 で は , PC-9801 の ドラ イ バ も あら か じ め BGI の 内 部 テー プ 
ル に 登録 きれ て いる の で , setnewdriver を 呼び 出す 必要 は な く な っ て いま 
す 。 

詳し く は 、initgraph お よび installuserdriver を 参照 し て くだ さい 。 
installuserdriver と 同じ で す 。 


PC-9801 シ リー ズ で の みろ 動作 し ます 。 


installuserdriver 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


setpalette 
機能 パレ ッ ト カ ラー の 1 つ を 変更 し ます 。 
形式 #include <graphics.h> 
void far setpalette(int co/orzzz。 int co/oy) : 
プロ ト タ イ プ graphics.h 
解説 setpalette は 、 パレ ッ ト の 中 の co/orzz 番目 の 項目 を , co/oy に 変更 し ま 


す 。 た と えば setpalette(0.5) は 、 カレ ント バ パレット の 最初 の カラ ー (バッ 
ク グ ラウ ンド カラ ー) を , 実際 の カラ ー 番 号 5 の カラ ー に 変更 し ます 。sze 
が カレ ント バレ ッ ト に 含ま れる 項目 の 数 と する と co/orzzyz は 0 か ら (sze- 
1) と の 間 の 値 を と る こと が で きま す 。 

PC-9801 お よび IBM PC の EGA/VGA の パレ ッ ト 中 の カラ ー は 。 
setpalette に よっ て , 1 項目 ご と に セッ ト す る こと が で きま す 。CGA で は , 
setpalette て 変更 で きる の は パレ ッ ト 中 の 最初 の 項目 (co/przzz 三 0, バッ 
ク グ ラウ ンド カラ ー) だ け で す 。 

setpalette に 渡す co/pr パラ メー タ は , graphics.h の 中 で 定義 され て いる 
以下 の シン ポリ ッ ク 定 数 で 表わす こと が で きま す 。 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


PC-9801 / CGA EGA / VGA 
名 前 値 名 前 値 
BLACK 0 EGA BLACK 0 
BLUE 1 EGA BLUE 1 
GREEN 2 EGA _ GREEN 2 
CYAN 3 EGA CYAN 3 
RED 4 EGA RED 4 
MAGENTA 5 EGA_MAGENTA 5 
BROWN 6 EGA LIGHTGRAY 7 
LIGHTGRAY 7 EGA BROWN 20 
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DARKGRAY 8 EGA DARKGRAY 56 


LIGHTBLUE 9 EGA LIGHTBLUE 57 
LIGHTGREEN 10 EGA LIGHTGREEN 58 
LIGHTCYAN 11 EGA LIGHTCYAN 59 
LIGHTRED 12 EGA_ LIGHTRED 60 
LIGHTMAGENTA 13 EGA LIGHTMAGENTA 61 
YELLOW 14 EGA_ YELLOW 62 
WHITE 15 EGA WHITE 63 


指定 で きる カラ ー は カレ ント グラ フィ ックス ドラ イ バ と グラ フィ ックス モ 
ー ド に 依存 し て いる こと に 注意 し て くだ さい 。 

バレット を 変更 する と , 変化 は 即座 に 画面 に 反映 され ます 。 パ レッ トカ ラ 
ー が 変化 する た びに , 画面 上 の その カラ ー が 表示 され て いる 部 分 は すべ て 
新しい カラ ー に 変わ り ま す 。 


注意 : IBM8514 ド ライ バ で は setpalette は 使用 で きま せん 。IBM8514 で 
は , setrgbpalette を 使用 し て くだ さい 。 


正しく な い 入 力 を setpalette に 与え る と 、 graphresult は -11 (grError) 
を 返し 、 カレ ント パレ ッ ト は 変更 され ませ ん 。 


戻り 値 あり ませ ん 。 
可 搬性 setpalette は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ アダ 


プ タ を 備え て いな けれ ば な り ませ ん )。 


関連 項目 getpalette, graphresult、 setallpalette, setbkcolor, setcolor, 
setrgbpalette 
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setrgbpalette (PC-9801) 


機能 


形式 


プロ ト タ イ プ ブ 


戻り 値 


可 搬性 
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ハー ドウ ェ ア バ レッ ト の 実際 の 色 を 定義 し ます 。 


#include <graphics.h> 


void far setrgbpalette(int co/orzzz。 int 7e。 jint greez, int 2/e) : 


graphics.h 


setrgbpalette は 、 co/orzi/7 で 指定 され た パレ ッ ト の 実際 の 色 を 7/eg, 
gee ヵ , 74e で 指定 し た 値 に 変更 し ます 。 

この 関数 に より PC-9801 シ リー ズ の 16 色 モー ド で は , 4096 色 中 か ら 任 意 の 
16 色 を 選ん で 使う こと が で きま す 。 

7e9, gyeen, の /e の 値 の 有効 和 囲 は カレ ント グラ フィ ックス モー ド に 依存 
し て いま す 。PC-9801 で は これ ら の 値 は 以下 の よう に な り ま す 。 


8 色 モー ド (PC98C8) 16 色 モ ー ド (PC98C16) 


7e の 0~-1 0-15 

8/ee7 0551 0-15 

が ze 0-1 0 一 15 
あり ませ ん 。 


setrgbpalette は PC-9801 シ リー ズ で の みろ 動作 し ます 。 


setpalette 
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setrgbpalette (IBM PC) 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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IBM8514 の カラ ー を 定義 し ます 。 


#include <graphics.h> 


void far setrgbpalette(int co/oz。 int 7e の , int g7eez, int ze) : 


graphics.h 


setrgbpalette は 、IBM8514 お よび VGA ドラ イ バ に お いて 使用 する こと 
が で きま す 。 

co/oyz477 は ロー ド す る バレット 項目 を 定義 し , 7e7, gyeen、 お よび が ue は 
バレット 項目 の 色 要 素 を 定義 し ます 。 

IBM8514 デ ィ ス プレ イ (お よび 256K カラ ー モ ー ド で の VGA) で は , co た 
zi72 の 範囲 は 0 一 255 に な り ま す 。VGA の 他 の モー ド で は , co/orzg7z の 範 
囲 は 0-15 で す 。 ze7, gyeez,、 お よび Z/e は 下位 バイ ト の み が 使 用 され , そ 
の 下位 バイ ト の 上 位 6 ビ ッ ト だ けが パレ ッ ト に ロー ド さ れ ま す 。 


注意 : 他 の IBM グラ フィ ックス アダ プ タ と の 互換 性 の た め に 、 BGI ドラ 
イ バ は 、 IBM8514 の 先頭 か ら 16 個 の バレット 項目 を EGA/VGA の デフ ォ 
ルト カラ ー と 同じ も の に 定義 し て いま す 。 こ れ ら の 値 は その まま 使用 する 
こと が で き 、 ま た , setrgbpalette で 変更 する こと も で きま す 。 

あり ませ ん 。 


setrgbpalette は 、 サ ポー ト す る グラ フィ ックス ディ スプ レイ アダ プ タ を 
備え た IBM PC お よび その 互換 機 で の み 動作 し ます 。 


setpalette 
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settextjustify 


機能 


形式 


プロ ト タ イ プ 


解説 


テキ スト 出力 の 位置 合わ せ を 設定 し ます 。 


#include <graphics.h> 
void far settextjustify(int orz、 int ve/7) : 


graphics.h 


settextjustify の 呼び 出し 後に 出力 され る テキ スト は , CP に 対し て 縦 方 向 
お よび 横 方 向 に 指定 され た 位置 合わ せ (テキ スト の どこ を CP に 合せ て 出 
力 する か ) が 行なわ れ ま す 。 デ フォ ルト の 位置 合わ せ の 設定 は LEFT _ 
TEXT (水平 方 向 )、TOP_TEXT (垂直 方 向 ) で す 。 

graphics.h の 中 の 列挙 型 zex7 74s7 は 、 settextjustify に 渡さ れる horiz と 
vert の 設定 に 使う 名 前 を 定義 し て いま す 。 


名 前 値 方 向 
LEFT TEXT 0 水平 
CENTER TEXT 1 水平 お よび 垂直 
RIGHT TEXT 2 水平 
BOTTOM_TEXT 0 垂直 
TOP_TEXT 2 垂直 


oz が LEFT TEXT に 等 し く , gyecoz が HORIZ DIR の 場合 に は , 
CP の 座標 は , outtext(srig) を 呼び 出し た 後 で は , textwidth (sg) だ 
け 増 加 す る こと に な り ま す 。 こ れ 以 外 の 位置 合わ せ の 設定 の 場合 に は CP 
は 変化 し ませ ん 。 

settextjustify は 、 outtext お よび outtextxy に よっ て 書か れる テキ スト 
に 効果 を 持ち ます 。 テ キス トモ ー ド や スト リー ム 関 数 に 対し て は 意味 を 持 
ち ま せ ん 。 
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関連 項目 


616 


settextjustify に 無効 な 入力 を 渡す と 、graphresult は -11 (grError) を 返 
し , カレ ント テキ スト の 位置 合わ せ の 指定 は 変化 し ませ ん 。 


あり ませ ん 。 


settextjustify は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
みろ 動作 し ます (IBM PC て で は,、 サポ ー ト する グラ フィ ックス ディ スプ レイ 
アダ プ タ を 備え て いな けれ ば な り ま せん )。 


gettextsettings、 graphresult、 outtext、 settextstyle 
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settextstyle 


機能 


形式 


プロ ト タ イ プ 


グラ フィ ックス 出力 の カレ ント テキ スト 属性 を セッ ト し ます 。 


#include <graphics.h> 


void far settextstyle(int 7oz7。 int の yec7oz。 int cg7sze) : 


graphics.h 


settextstyle は 、 テ キス ト フ ォ ン ト , テキ スト の 表示 され る 向き , 文字 の サ 
イズ を セッ ト し ます 。 settextstyle の 呼び 出し は 、 outtext お よび outtex- 
txy に よっ て 出力 され る テキ スト すべ て に 影響 を 与え ます 。 

settextstyle に 渡さ れる パラ メー タ /ozr、g の 7ec7oz、 cg7sze は 次 に 示す よ 
う な 意味 を 持ち ます 。 


76zr : 1 組 の 8X16 ビ ッ ト マ ッ プ フォ ント (IBM PC で は 8x8) と , い くつ 
か の スト ロー ク フ ォ ント が 使用 で きま す 。8X16 (また は 8X8) ビッ トマ ッ 
プ フ ォ ント が デフ ォ ル ト で す 。graphics.h の 中 で 定義 きれ て いる 列挙 型 
/6z7_zg が es に より 、 こ うし た 種々 の フォ ント の 設定 に 用 いる 名 前 が 与え ら 
れ て いま す (次 に 示す 表 を 参照 し て くだ さい )。 


名 前 値 説明 


DEFAULT FONT 
TRIPLEX FONT 
SMALL FONT 
SANSSERIF FONT 
GOTHIC FONT 


8X16 (8X8) ビッ トマ ッ プ フォ ント 
スト ロー ク ・ ト リプ レッ クス フォ ント 
スト ロー ク ・ ス モー ルフ ォ ン ト 

スト ロー ク ・ サ ンス セリ フフ ォ ン ト 
スト ロー ク ・ ゴ シッ ク フ ォ ント 


ょ の らら ワ の 
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デフ ォ ル ト の ビッ トマ ッ プ フォ ント は その まま 使用 で きま す 。 ストロー ク 
フォ ント は *.CHR と いう ディ スク ファ イル に 著 え られ て お り , 一 度 に ひ 
と つ し か メモ リ に 置け ませ ん 。 そ の た め , スト ロー ク フ ォ ント (一 番 最後 
に 選ん だ スト ロー ク フ ォ ント と 別 の 種類 の 物 ) を 選ぶ と き に は , 対応 する 
*※.CHR ファ イル を ディ スク か ら 読 み 込 まな を く て は いけ ませ ん 。 い くつ か 
の スト ロー ク フ ォ ント を 使用 する と き , この 読み 込み を 避け る た め に は , 

プロ グラ ム に フォ ント ファ イル を リン ク す る こと に な り ま す 。BGIOBJ ユ 
ー テ ィ リ ティ で これ を オプ ジェ クト ファ イル に 変換 し , registerbgifont 
で それ を 登録 する と いう 手順 で リン ク す る こと が で きま す (BGIOBJ に つ 
いて は ユー ザー ズ ガ イド 付 録 C で 説明 し て いま す )。 

漢字 が 使用 で きる の は デフ ォ ル ト の ビッ トマ ッ プ フォ ント だ け で す 。 


gecon : サポ ー ト され て いる フォ ント の 向き は , 水平 テキ スト ( 左 か ら 
右 ) と 垂 商 テキ スト ( 反 時 計 回 り に 90 度 回 転 し た 向き ) で す 。 デ フォ ルト 
の 方 向 は HORIZ DIR で す 。 


名 前 値 方 向 


HORIZ DIR 0 左 か ら 右 へ 
VERT DIR 1 下 か ら 上 へ 
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cg/sze : 文字 の 大 き さ は c4g7sze 因子 を 使っ て 拡大 する こと が で きま す 。 
cgrsze が が 0 で な い 場 合 は 、 ビッ トマ ッ プ お よび スト ロー クタ 文字 が 影響 を 受 
け ま す 。 cgrsze が 0 の 場合 は 、 スト ロー ク 文 字 だ けが 影響 を 受け ます 。 


田 cgrsze が 1 の 場合 , outtext と outtextxy は 画面 上 の 8X16 ビ ピク セル 
の 長方形 の 領域 に:。8X16 ビ ッ ト マ ッ プ フォ ント の 文字 を 表示 し ます 。 

較 crsze の 72 の 場合 , これ ら の 出力 関数 は 16 メ <32 ビ クセ ル の 長方形 の 領 
域 に 。8X16 ビ ッ ト マ ッ プ フォ ント の 文字 を 表示 し ます (以下 同様 に 標 
準 サ イズ の 10 倍 cgrsze ニ 10 まで 可能 で す )。 

較 22zsze が 0 の 場合 , 出力 関数 outtext と outtextxy は ,、 デ フォル ト の 
文字 拡大 因子 4 (4 倍 )、 あ る い は setusercharsize に よっ て 与え られ る 
ユー ザ 定 義 の 文字 サイ ズ の どちら か を 使用 し て , スト ロー ク フ ォ ント 
テキ スト を 拡大 し ます 。 


テキ スト の 実際 の 大 き さ を 調べ る に は , 必 ら ず textheight と textwidth 
を 使用 し て くだ さい 。 


戻り 値 あり ませ ん 。 
可 搬性 settextstyle は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 
動作 し ます (IBM PC で は ,、 サポ ー ト する グラ フィ ックス ディ スプ レイ ア 


ダ プ タ を 備え て いな けれ ば な り ま せん )。 


関連 項目 gettextsettings, graphresult、 installuserfont, settextjustify, 
setusercharsize, textheight、 textwidth 
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setusercharsize 
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プロ ト タ イ プ 


解説 


戻り 値 


可 搬性 


関連 項目 


620 


スト ロー ク フ ォ ント 文字 の 幅 と 高 さ を 変更 し ます 。 


#include <graphics.h> 


void far setusercharsize(int 4/x。int gw。int か 。int の yy) : 
graphics.h 


setusercharsize は 、 グラ フィ ックス 関数 で 使用 きれ る スト ロー ク フ ォ ン 
ト に よる テキ スト の サイ ズ を 制御 し ます 。setusercharsize に よっ て セッ 
ト さ れる 値 は , settextstyle の cgrsze パラ メー タ が 0 の と き に の み 有 効 で 
す 。 し た が っ て , setusercharsize の 前 に settextstyle を 呼び 出し て cg/s- 
ge を 0 に セッ ト し て お く 必 要 が あり ます 。 

setusercharsize を 使っ て , 幅 と 高き を 決定 する スケ ー ル 因子 を 指定 し ま 
す 。 デ フォ ルト 幅 は 4/x/g の xr 倍 さ れ , デフ ォ ル ト の 高き は 4 の ゆ /g の yy 倍 
され ます 。 た と えば , テキ スト の 幅 を 2 倍 に , 高き を 50% 高 くす る に は 次 の 
よう に し ます 。 


77( の 本 


2 
が 47 ウニ 3: の gy ニ 2: 
あり ませ ん 。 
setusercharsize は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で 
の みろ 動作 し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レ 


イア ダ プ タ を 備え て いな けれ ば な り ま せん )。 


gettextsettings、 graphresult、 settextstyle 
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例 すず 1nclude <graphics.h> 
すま 1nckude <conio.h> 


main() 

{ 
1nt graphdriver = DETECT, graphmodei /* 自動 検出 を 要求 */ 
char *tit1e = "TEXT in a BOX"i 


1nitgraph(&graphdriver。 &graphmode, * /* 初期 化 */ 


settext just1fy(CENTER_TEXT。 CENTER_TEXT): 
setusercharsize(1,1,1.1): 

settextsty1e(TRTPLEX_ FONT HORTZ_DTR, USER_CHAR_STZE): 
setusercharsize(200, textwidth(tit1e) , 100, texthetght(tit1e) ) : 
rectang1e(0。 0, 200, 100): 

outtextxy(100。 50, title): 

getche( ) 

c1osegraph(): 
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setviewport 

機能 グラ フィ ックス 出力 用 の カレ ント ピュー ポ ー ト を 設定 し ます 。 

形式 #include <graphics.h> 
void setviewport(int /g77。 int 7op, int 7g が 7。 int 2o/7oz。 int c め ) : 

プロ ト タ イ プ graphics.h 

解説 setviewport は 、 グラ フィ ックス 出力 用 の 新しい ビュ ー ポ ー ト を 作り ます 。 
ビ ピュー ポー ト の 四隅 は , 絶対 画面 座標 の (g7,7op) と (7g が 7.2oro) に よっ 
て 与え られ ます 。 現 在 位置 (CP) は ビュ ー ポ ボー ト の (0.0) へ 移 き れ ま す 。 
引数 め は , 描画 が カレ ント ビュー ポ ー ト の 境界 で クリ ッ ピ ング され る 
( 端 が 切り 取ら れる ) か どう か を 決め ます 。 プ ログ ラム の 中 で setyiewport 
を 呼び 出し た と き に c め が 0 で な い 場 合 は 、 す べ て の 描画 は カレ ント ビュ 
ー ポ ー ト に よっ て クリ ッ ピ ング され ます 。 
無効 な 入力 が setviewport に 渡さ れる と , graphresult は -11 を 返し , カレ 
ント ビ ピュー ポー ト の 設定 は 変化 し ませ ん 。 

戻り 値 あり ませ ん 。 

可 搬性 setyiewport は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 
動作 し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ ア 
ダ プ タ を 備え て いな けれ ば な り ま せん )。 

関連 項目 clearviewport、 getviewsettings, graphresult 
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ーー バー バーバ ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


setvisualpage 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


例 


ビジ ュ ア ル グ ラ フ ィ ッ クス ペー ジ 番 号 を セッ ト し ます 。 


#include <graphics.h> 
void far setvisualpage(int pge) ・ 


graphics.h 


setvisualpage は 、 pgge を ビジ ュ ア ル グ ラ フ ィ ッ クス ペー ジ に セッ ト し ま 
宮 。 


あり ませ ん 。 

setvisualpage は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
み 動 作 し ます (IBM PC で は , サポ ー ト する グラ フィ ックス ディ スプ レイ 
アダ プ タ を 備え て いな けれ ば な り ま せん )。 


graphresult、 setactivepage 


setactivepage を 参照 し て くだ さい 。 


グラ フィ ックス 関数 リフ ァ レ ンス 623 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


setwritemode 

機能 グラ フィ ックス モー ド に お ける 描線 の 書き 込み モー ド を 設定 し ます 。 

構文 #include <graphics.h> 
void far setwritemode(int zzoge) : 

プロ ト タ イ プ graphicsh 

説明 拓 の 2 つの 定数 が 定義 され て いま す 。 

COPY POT =0 /* MOV */ 

XOR_POT = ュ /* XOR */ 

各 定数 は , 線 の 各 ビ クセ ル と 画面 の 対応 する ビク セル と の 間 の 2 進 演算 に 対 
応 し て いま す 。 す な わ ち , COPY_PUT は アセ ャ ンプ ブリ 言語 の MOV 命令 を 
使っ て , 画面 上 に ある も の すべ て に 対し て 線 を 上 書き し ます 。 XOR_PUT 
は 、 XOR 命令 を 使っ て , 画面 上 に ある も の と 線 に 対し て 排他 的 OR 操作 を 
行ない ます 。 連 続 し て 2 回 XOR 命令 を 行う と, 線 は 消え る こと に な り , 画 
面 は 元 通り に な り ま す 。 

注意 : setwritemode は 現在 の と ころ line, linerel, lineto. rectangle, 
drawpoly に 対し て だ け 有 効 で す 。 

戻り 値 あり ませ ん 。 

可 折 性 setwritemode は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の 
みろ 動作 し ます (IBM PC て では. サポ ー ト する グラ フィ ッ ク ス デ ィ ス プレ イ 
アダ プ タ を 備え て いな けれ ば な り ま せん )。 

関連 項目 drawpoly、 line、 linerel、 lineto、putimage 
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textheight 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


文字 列 の 高き を ピク セル 単位 で 返し ます 。 


#include <graphics.h> 
int textheight(char far * 7exs/7g) : 


graphics.h 


グラ フィ ックス 関数 textheight は 、 カレ ント フォ ント サイ ズ と 拡大 因子 
を 用 いて 文字 列 7exfs7g の 高き を ビク セル 単位 で 求め ます 。 

この 関数 は 、 行 間 の スペ ー ス を 調整 し た り 、 ビ ュー ポー ト の 高 さ を 計算 し 
た り , グラ フ 上 や ポッ クス の 中 に フィ ッ ト す る タイ トル の 大 き さ を 求め た 
い 場合 に 便利 で す 。 

た と えば PC-9801 で は 、8X16 の ビッ トマ ッ プ フォ ント で , 拡大 因子 が 
1 (settextstyle で セッ ト さ れる) の と き , 文字 列 "Turbo C" は 16 ビ ピクセル 
の 高き に な り ま す 。IBM PC で は , 8X8 ビ ッ ト マ ッ プ フォ ント で 拡大 因子 
が 1 で あれ ば , "Turbo C" の 高 さ は 8 ビク セル に な り ま す 。 

textheight を 使う と 、 い ちい ち 手 計算 を し な く て も 、 文字 列 の 高 さき を 求め 
る こと が で きま す 。 こ の 関数 を 使え ば , 違っ た フォ ント が 選ば れ た 場合 で 
も , ソー スコ ー ド を 変更 する 必要 が な いよ うに する こと も で きま す 。 


textheight は , テキ スト の 高き を ビク セル 単位 で 返し ます 。 
textheight は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ 


プ タ を 備え て いな けれ ば な り ま せん )。 


gettextsettings、 outtext、 outtextxy、 settextstyle、 textwidth 
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textwidth 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


626 


文字 列 の 幅 を ビク セル 単位 で 返し ます 。 


#include <graphics.h> 


int far textwidth(char far * /ex7/77g) ・ 


graphics.h 


textwidth は , 文字 列 の 長き ふ 、 カレ ント フォ ント サイ ズ , 拡大 因子 を 用 い 
て , 文字 列 exs/g の 幅 を 求め ます 。 

この 関数 は 、 ビュ ー ポ ー ト の 幅 を 計算 し た り ,、 グラ フ 上 や ポッ クス の 中 に 
フィ ッ ト す る タイ トル の 大 きき さ を 求 め た い 場 合 に 便利 で す 。 

textwidth を 使う と, いち いち 手 計算 を し な く て も 、 文字 列 の 幅 を 求め る こ 
と が で きま す 。 こ の 関数 を 使え ば , 違っ た フォ ント が 選ば れ た 場合 で も , 
ソー スコ ー ド を 変更 する 必要 が な いよ うに する こと も で きま す 。 


textwidth は ,、 テキ スト の 高 さ を ビク セル 単位 で 返し ます 。 
textwidtht は PC-9801 シ リー ズ (また は IBM PC と その 互換 機 ) で の み 動 
作 し ます (IBM PC で は 、 サポ ー ト する グラ フィ ックス ディ スプ レイ アダ 


プ タ を 備え て いな けれ ば な り ま せん ) 。 


gettextsettings、 outtext、 outtextxy、 settextstyle、 textheight 
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PC-9801 の ROM-BIOS イン ター フェ ー ス 


PC-9801 用 ROM-BIOS イン ター フェ ー ス ルー チン は , マ シン の ROM チッ プ に 組み 込ま 
れ て いる ハー ドウ ェ ア 共 本 制御 レー チン を 駆動 する た め の イ ンタ ー フ ェ ー ス ルー チン で す 。 
これ ら の 関数 を 使用 すれ ば , マシ ン の 機能 を 最大 限 に 引き 出す こと が で きま す 。 た だ し 。 
他 機 種 と の 互換 性 は まっ た く な い の で , 可 搬性 の ある プロ グラ ム を 作成 し よう と する の で 
あれ ば , この イン ター フェ ー ス は 使用 すべ き で は あり ませ ん 。 ここ て 説明 する すべ て の 関 
数 は , PC-9801 シ リー ズ で の み 使 用 する こと が で きま す 。 

ROM-BIOS イン ター フェ ー ス を 使う と, 次 の よう な こと が 行なえ ます 。 


一 シス テム 情報 を 得る (bios98equip な ど ) 

一 キー ボー ドイ ンタ ー フ ェ ー ス (bios98key) 

田 デ ィ ス ク 装 置 の 操作 (bios98disk な ど ) 

圏 プリ ンタ の 制御 (bios98prin) 

田 RS-232C の 制御 (bios98com、 bios98com_init な ど ) 

圏 マ ウス の 制御 (bios98mouse な ど ) 

田 イ ンタ ー バ ル タ イ マ の 制御 (bios98timer な ど ) 

田 日 付 時 刻 の 読み 出し と 設定 (bios98time) 

一 ROM の フォ ント バタ ー ン の 読み 出し と ユー ザ 定 義文 字 の 設定 (getfont な ど ) 


な お , イン ター フェ ー ス の 詳細 な 仕様 に つい て は , 各 機 種 の 「 ユ ー ザ ー ズ マニ ュ ア ル 」 


お よび アス キー 出版 局 の 「PC-9800 シリ ー ズ テク ニカ ル デ ー タ ブッ ク 」 な ど を 参照 し て 
くだ さい 。 


パケ ッ ト 構 造 体 


各 イ ンタ ー フ ェ ー ス ルー チン で は , BIOS と の デー タ の や り と り を, 構造 体 を 通し て 行 な 
いま す ( 構 造 体 を 使用 し な い 関 数 も あり ます が )。 こ の 節 で は , こう し た 構造 体 の こと を パ 
ケッ ト と 総称 し て いま す 。 各 ル ー チ ン を 使用 する 際 に は , パケ ッ ト (構造 体 ) の 所 定 の 位 
置 (メン バ ) に 必要 な パラ メー タ を 入れ , その パケ ッ ト を 引数 と し て 関数 を 呼び 出し ます 。 

パケ ッ ト 構 造 体 の 最初 の 2 つの メン バ は , すべ て の BIOS 関数 に お いて 共通 で , 1 番目 が 
機能 コー ド (メン バ 名 cmmd), 2 番目 が ステ ー タ ス (stus) と な っ て いま す 。cmmd に は 
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FROM ルー チン に 与え る 機能 コー ド を 指定 し ます 。 stus は , ROM ルー チン を 呼び 出し た 後 
の 状態 (ステータ ス ) で , BIOS の 返し た 値 が 格納 され ます (stus を 使用 し な い 関 数 も あり 
ます )。 

パケ ッ ト 構 造 体 の 3 番目 以降 の メン バ は , 各 関 数 に よっ て 異な り , 対応 する ROM ルー チ 
ン に 応じ た パラ メー タ を 指定 し た り , ROM ルー チン が 返し た 値 を 格納 し た り し ます 。 

パケ ッ ト の 解説 で は , 次 の よう な 形式 の 表 を 使っ て 説明 し て いま す ( た だ し , bios98disk 
お よび bios98harddisk は , これ と は や や 異な り ま す 。 これ ら に つい て は 該当 の ペー ジ を 見 
て くだ さい )。 


PACKET NAME | 1 2 3 4 
cmmd AH R R R R 
stus AH WW WW W 
info_1 CX W メ メ 
info 2 ALCH| X R W X 
info_ 3 CL X 。 Rx Rx XX 
info_4 ALCH| X RW RW R 


表 の 一 番 上 の 行 は , 構造 体 の 型 名 と 使用 で きる 機能 コー ド (cmmd に 指定 する 値 ) で 
す 。 機 能 コ ー ド は 10 進 数 で 表わし て いま す 。 

2 行 目 以下 は 左 か ら 、 メン バ 名 。 (その 関数 ある い は BIOS が 使用 する 場合 に は ) レジ ス 
タ 名 、 お よび その メン バ が どの よう に 使用 され る か を 表わす 記号 で す 。 こ こ で 使わ れる 記 
号 は 次 の よう な 意味 を 持っ て いま す 。 


R プロ グラ ム か ら BIOS に 渡す 

W BIOS か ら プ ログ ラム に 返す 

RW  。 プロ グラ ム か ら BIOS に 渡し , BIOS か 返す 

Rx プロ グラ ム か ら BIOS に 渡す 、 BIOS は 上 位 8 ビ ッ ト の み を 使用 する 
メ 使用 し な い (以前 の 値 は 保証 し な い ) 


当然 の こと な が ら , cmmd は すべ て R に な り ま す 。 ま た stus は (使用 され る 場合 は ) す 
べ て W に な り ま す 。 それ 以下 は 関数 に よっ て 異な っ て いま す 。 
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bios98com 


機能 RS232C-BIOS を 操作 し ます 。 


形式 #include <bios98.h> 
unsigned bios98com(COM_INFO * cz が ) : 


プロ ト タ イ プ bios98.h 


解説 bios98com は , 受信 デー タ サ イズ の 取得 、 データ の 送信 , デー タ の 受信 , 
コン トロ ー ラ へ の コマ ンド 出力 , コ ント ロー ラ の 状態 の 取得 を 行ない ます 。 
構造 体 COM_INFO は , bios98.h の 中 で 次 の よ うに 定義 され て いま す 。 


typedef struct { 


une1gned char */ 
unstgned char // 
unsigned nt /* 受信 デー タ サ イズ */ 
unsigned char /* 送受 信 デ ー タ き / 


unsigned char /* 受信 時 デー タ の 状態 */ 

uns1gned char 加 /* コン トロ ー ラ の 状態 。*/ 

uneigned char port_infi /* シス テム ポー ト の 状態 */ 
) COM_TNEOi 


割り 込み ベク タテ ー プ ブル (00000h 一 003FFh) 内 の タイ マ 割 り 込 み と , RS- 
232C-BIOS で 使用 する 割り 込み ベク タ は , 常に ROM 内 の BIOS ルー チン 
を 指し て いる と は 限ら な いた め , bios98com で は , これ ら を 利用 可能 な 状 
琵 に し て か ら プ ログ ラム を 実行 し て いま す 。 通常 は 。 ユー ザ プ ロ グラ ム が 
終了 し た 時 点 で , 自動 的 に 割り 込み ベク タ を 復帰 させ て いま す が , ユー ザ 
プロ グラ ム を 常駐 終了 させ た い 場 合 に は , 下 に 示す 変数 を プロ グラ ム 内 で 
外部 定義 し て くだ さい 。 


int be_com=1 


bs_com を 0 以外 に する と , タイ マ 割 り 込み (INT 0Ch) と RS-232C BIOS 
(INT 19h) の 割り 込み ペク タ を , 元 の 状態 に 戻さ な いよ うに な り ま す 。 

MS-DOS が サポ ー ト する RS-232C イン ター フェ ー ス と 混在 し て 使用 し な 
いで くだ さい 。 また , MS-DOS の RS-232C デバ イス ドラ イ バ は 必要 と し ま 
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せん 。 


戻り 値 各 コ マン ド を 実行 し た 結果 は 16 ビ ッ ト 中 の 下位 8 ビッ ト に 設定 され 返さ れ 
ます 。 ま た , パケ ッ ト 内 の メン バ stus に も 格納 され ます 。 


還 パ ケッ ト 内 の デー タ の 授受 


COM_INFO 2 3 4 5 6 
cmmd AH R R R R R 
stus AH W_WwW _ ww_W W 
data_siz CX W  ※ メ に 3 メ 
data ALCH | X R W ※ し 3 
data_inf CL メ X 。 W  ※ メ 
ctrlinf |ALCH| X ※ ※ R WW 
port_inf CL メ メ し 3 ※ W 


関連 項目 bios98com_ch2, bios98com ch3. 
bios98com_init, bios98com init ch2, bios98com_init ch3 
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すま 1nc1ude <stdio.h> 
すま include <bios98 .h> 


#define ON 1 
#define OFF 0 


void com_init(unsigned char *buf) 


{ 

COM_INIT cinti 

cint.cmmd = 1: /* X パラ メー タ つ き */ 
cint.transfer = Ox06i 

cint.mode inf = Ox5E: 

cint.cmmd inf = 0x37: 

cnt.recy_buf = bufi 

cint.recv_sliz = 256i 

clnt.t1me_snd = 0x10: 


cint.time_rcy = 0xOFi: 
btos98com_init(&ctnt): /* RS-232C の 初期 化 */ 
1f (cint.stus 1= 0) 
Printf(*init stuseZ02X. ぜ mn" 。 cint.stus)i 
} 


unsigned com recysize() 
【 
COM_TNEO cinfi 
cinf.cmmd = 2: 
blos98com(&cinf): /* 受信 デー タ サ イズ の 取得 */ 
1f (cinf.stus 1= 0) 
Printf("recvslze_stus=z02X.\n" 。 cinf.stus): 
return cinf.data eizi 
} 


void com send(unsigned ch) 
{ 
COH_TNEO cinfi 
で cinf.cmmd = 3: 
cinf.data = chi 
bios98com( &cinf ): /* デー タ 送 信 */ 
1E (cinf.stus 1= 0) 
Printf("send stusez02X.\n" 。 cinf.stus): 
} 


unsigned com_recy(vod) 
6 
COM_TNEO cinfi 
clnf.cmmd = 4 
blos98com(&clnf)j /* デー タ 受 信 */ 
1f(cnf.stus 1= 0) 
Printf(*recy_stus=Z02X.n"。 clnE.stus)』 
Feturn Clnf.datai 
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632 


void main() 7* パソ コン 対 バ パソ コン 通信 テス ト */ 
1 
unsigned char buf[300], sstr[80]: 
int sch, rch, send、 1。ni 
com_init(buf): 
while (1) ( 
gets(sstr): /* キー デー タ の 入力 */ 
1E (sstr[0] == 0) { 
Printf(" 受 信 を 開始 し ます 。 \n*): 
while ((rch = com recy()) != 0) 
PrintE("Xc" rch):  /* 受信 デー タ の 表示 */ 
printf("\n*)j 
} 
else ( 
printf(" 送 信 を 開始 し ます 。 *\n"): 
n = strlen(sstr) + 1 
for (1 = 0』 1 < ni 4+) 人 
sch = sstr[i]i 
do { 
while (com recvsize() > 0) { 
rch = com_recv(): 
switch (rch) ( 

Case Ox13 : send = OFFi 
printf("\n 送 信 休 止 \n*): 
breaki 

case Ox11 : send = ONi 
Printf("wn 送 信 再 開 \n"): 


breaki 

default 。 + /* 送信 中 に 受信 し た デー タ 
printf("zc"。 rch): 
breaki 


} 
1f (send == ON) breaki 
} 
) while (send == OFP)i 
com_send(sch): /* デー タ の 送信 */ 


を / 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


bios98com_ch2 


機能 RS-232C の 2 回 線 目 用 イン ター フェ ー ス で す 。 


形式 #include <bios98.h> 
unsigned bios98com_ch2(COM_INIT * cz : 


プロ ト タ イ プ bios98.h 


解説 拡張 RS-232C の 2 回 線 目 用 の イン ター フェ ー ス で す 。 
詳細 に つい て は bios98com を 参照 し て くだ さい 。 


ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


bios98com_ch3 


機能 RS-232C の 3 回 線 目 用 イン ター フェ ー ス で す 。 


形式 #include <bios98.h> 
unsigned bios98com ch3(COM_INIT * cz) : 


プロ ト タ イ プ bios98.h 


解説 拡張 RS-232C の 3 回 線 目 用 の イン ター フェ ー ス で す 。 
詳細 に つい て は bios98com を 参照 し て くだ さい 。 


PC-9801 の ROM-BIOS イ ンタ ー フ ェ ー ス 633 


bios98com_init 


形式 


プロ ト タ イ プ 


634 


RS-232C を 初期 化し ます 。 


#include <bios98.h> 
unsigned bios98com_init(COM_INIT * cp): 


bios98.h 


bios98com_init は , RS-232C の 初期 化 , 制御 を 伴う 初期 化 を 行ない ます 。 
構造 体 COM_INIT は , bios98.h の 中 で 次 の よ うに 定義 され て いま す 。 


typedef struct ( 

uns1gned char cmmdi /* 機能 コー ド / 
char etusi /* 実行 後 の 状 態 */ 
char transferi: /* トラ ンス ファ レー ト き / 
char mode_inf: /* モー ド 指 定 3/ 
char cmmd_inf: /* コマ ンド 指定 44 
char *recv_buE: /* 受信 バッ ファ 人 
nt recv_sizi /* 受信 バッ ファ サイ ズ // 

unsigned char time_snd: /* 送信 時 の タイ ム ア ウ ト 時 間 */ 

unsigned char time_rcvi /* 受信 時 の タイ ム ア ウ ト 時 間 */ 
}) COM_INITi 


割り 込み ベク タテ ー プ ブル (00000h 一 003FFh) 内 の タイ マ 割 り 込 み と , RS- 
232C-BIOS で 使用 する 割り 込み ベク タ は , 常に ROM 内 の BIOS ルー チン 
を 指し て いる と は 限ら な いた め , bios98com_init で は 、 これ ら を 利用 可能 
な 状態 に し て か ら プ ログ ラム を 実行 し て いま す 。 通常 は ユー ザ プ ロ グラ 
ム が 終了 し た 時 点 で , 自動 的 に 割り 込み ベク タ を 復帰 させ て いま す が , ユ 
ー ザ プロ グラ ム を 常駐 終了 させ た い 場 合 に は , 下 に 示す 変数 を プロ グラ ム 
内 で 外部 定義 し て くだ さい 。 


nt be_conm=1: 


5 co を 0 以外 に する と , タイ マ 割 り 込み (INT 0Ch) と RS-232C-BIOS 
(NT 19h) の 割り 込み ベク タ を , 元 の 状態 に 戻 き ない よう に な り ま す 。 

MS-DOS が サポ ー ト する RS-232C イン ター フェ ー ス と 混在 し て 使用 し な 
いで くだ さい 。 また , MS-DOS の RS-232C デバ イス ドラ イ バ は 必要 と し ま 
せん 。 拡 張 RS-232C (bios98com_init ch2, bios98com_init ch3) で 使用 
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する と き , パケ ッ ト 内 の トラ ンス ファ レー ト transfer は 使用 し ませ ん ( 増 
設 ポ ー ド 上 の ディ ッ プ スイ ッ チ で 指定 し ます )。 


戻り 値 各 コ マン ド を 実行 し た 結果 は 16 ビ ッ ト 中 の 下位 8 ビッ ト に 設定 され 返さ れ 
ます 。 ま た , パケ ッ ト 内 の メン バ stus に も 格納 され ます 。 


圏 パ ケッ ト 内 の デー タ の 授受 


COM_INIT 0 1 
cmmd AH R R 
stus AH W_W 
transfer AL R R 
mode inf | CH R R 
cmmd inf| CL R R 
recv buf | ESDI | R R 
TecV_Siz DX R R 
time_snd BH R R 
time_rcv BL R R 

可 搬 性 PC-9801 シ リー ズ で の みろ 動 作 し ます 。 


関連 項目 bios98com, bios98com_ch2, bios98com_ch3, 
bios98com_init ch2, bios98com init ch3 


例 bios98com を 参照 し て くだ さい 。 
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pios98com_init_ch2 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


2 回 線 目 の RS-232C を 初期 化し ます 。 


#include <bios98.h> 
unsigned bios98com init ch2(COM_INIT * cz) 


bios98.h 


拡張 RS-232C の 2 回 線 目 用 を 初期 化 を 行ない ます 。 
詳細 に つい て は , bios98com_init を 参照 し て くだ さい 。 


拡張 RS-232C 増設 ボー ド を 実装 し な いで この 関数 を 呼び 出す と 0 以外 を 
返し ます 。 


bios98com_init_ch3 


形式 


プロ ト タ イ プ 


戻り 値 


636 


3 回 線 目 の RS-232C を 初期 化し ます 。 


#include <bios98.h> 
unsigned bios98com_init ch3(COM_INIT * cz : 


bios98.h 


拡張 RS-232C の 3 回 線 目 用 の イン ター フェ ー ス で す 。 
詳細 に つい て は bios98com_init を 参照 し て くだ さい 。 


拡張 RS-232C 増設 ボー ド を 実装 し な いで この 関数 を 呼び 出す と , 0 以外 を 
返し ます 。 
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bios98disk 


機能 ディ スク BIOS を 操作 し ます 。 


形式 #include <bios98.h> 
unsigned bios98disk (DISK_INFO * の ん ) : 


プロ ト タ イ プ bios98.h 


解説 bios98disk は , フロ ッ ピ ィ デ ィ ス ク を 直接 制御 する た め の ル ー チ ン で す 。 
パケ ッ ト 引 数 ぶ を 内 の メン バ cmmd に より 各種 の コマ ンド を 実行 し ます 。 
構造 体 DISK_INFO は , bios98.h の 中 で 次 の よう に 定義 され て いま す 。 


typedef struct ( 


unstgned char cmmdi /* DISK コ マン ド */ 
unsigned char stuei /* 実行 後 の 状態 */ 
unsigned char device_typi  /* デバ イス タイ プ / ユ ニッ ト 番 号 */ 
unsigned nt data_ elzi /* デー タ サ イズ #*/ 


unstgned char sector_slz:  /* セク タ サ イズ +*/ 
unsigned char cy1ind num:  /* シリ ンダ 番号 */ 


char head_numi /* ヘッ ド 番 号 */ 
char /* セク タ 番 号 */ 
unsigned char /* デー タ 域 */ 
) DISK_TNFO: 
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戻り 値 各 コ マン ド を 実行 し た 結果 は ,16 ビ ッ ト 中 の 下位 8 ビッ ト に 設定 され 返さ れ 
ます 。 ま た , パケ ッ ト 内 の メン バ stus に も 格納 され ます 。 


還 パ ケッ ト 内 の デー タ の 投 受 


1MB/640KB フロ ッ ン ピ ィ ディ スク の 場合 : 


DISK INFO |1 2 3 4 6 7 8 910ll1214 
cmmd AH |R R R R R R R R R R R R 
stus AH IWWWWWWWWwWWwWWwWWwWWw 
device typ| AL |IR R R RRRRRRRRR 
data_siz BX |IR R Rx x RxxRRRR 
sector siz | CH |IR R xx xX R x WRRRR 
cylindnum| CL |IR R R x xX R XRWR RRR 
head num | DH |IR R x x x R xRWR R R R 
sector num| DL |R R x x x R xX W R R _R _R 
data buf IESBPIR R x x x R xx RRRR 

320KB フロ ッ ピ ビィ ディ スク の 場合 : 

DISK INFO 1 2 5 6 7 8 13 
cmmd AH |R R R R R R R 
stus AH IWWWWWwWWW 
devicetyp| AL |IR R RRRRR 
data_siz BX |IR R xX x R X 
sector siz | CH |IR R xX xX R X ※ 
cyliindnum| CL |IR R x x R x x 
headnum | DH |R R x x R x x 
sector num| DL |R R x x R ※ ※ 
data buf |IESBPIR R x x R x 


638 
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機能 コー ド (DISK コマ ンド ) は 以下 の よう な 意味 を 持っ て いま す 。 


番号 コマ ンド コー ド 
1MB/640Kb 320Kb 
1 READ DATA OxTe Ox06 
2 WRITE DATA OxT5 0x05 
3 SEEK OxU0 
4 RECALIBRATE OxV7 
5 FORMAT DRIVE Ox0C 
6 INITIALIZE 0x03 0x03 
7 VERIFY 0xT1 0x01 
8 SENSE Ox04 0x04 
9 READ ID 0xWA 


WRITE DELETED DATA OxT9 
READ DELETED DATA OxTC 


ご ビ ご 


12 READ DIAGNOSTIC 0xW2 
13 SET OPERATION MODE OxOE 
14 FORMAT TRACK 0xWD 


上 の 表 の コー ド 使 われ て いる サ プ コ マン ド (上 位 4 ビ ッ ト ) は 以下 の よう 
な 値 と 意味 を 持っ て いま す 。 


上 位 4 ビット ビ ピット | 説明 
T IMT MF r SK MT | トラ ッ ク 指 定 
Ul0 0 r ュ MF 密度 指定 
V|0 0 r 0 r 再 試行 指定 
W| 0 MEF r SK SK シー ク 指 定 
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640 


#1nclude <bios98 .h> 


Yoid read_sec(unsigned char 


{ 


} 


DTSK_TNFO dinf 
dinf.cmmd ー OxDA: 
dinf.device_typ = Ox90: 
dinf.sector_slz = -1 
dnf.cy1ind num = ci 
dinf.head num 。 =hbi 
dinf.sector_num = -1 
bios98disk(&dinf): 
dinf.cmmd - OxD6i 
dinf.data_siz = 1024: 
dinf.sector_num = si 
dinf.data_buf = bufi 
bios98disk(s&dinf): 


*buf。 int c。 nt h。 int s) 


/* 標準 フロ ッ ピ ィ ド ライ ブ 0 */ 


/* セク タ サ イズ の 取得 */ 


/* デー タ の 読み 出し */ 


Printf("stus=Z02X。 CY=Zd 。 HD=Zd 。 SNeZd。 SS=Zd .\n"。 
dinf.stus,。 dinf.cy1ind num。 dinf.head num。 
dinf.sector_num, dinf.sector_slz)s 


Yoid main() 


6 


char buE[2048]: 
nt は 。 ]。 ki 


for (1 = 0i 1 <m 76j』 1+) ( 
for (] = 0 ] <= 1 1+) (て 


for (k = 1j k <e 
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bios98equip 


機能 シス テム 情報 を 取得 し ます 。 


形式 #include <bios98.h> 
unsigned bios98equip (void) : 


プロ ト タ イ プ bios98.h 


解説 bios98equip は , 現在 シス テム に 接続 され て いる 機器 情報 を 返し ます 。 


注記 : この 関数 は BIOS イン ター フェ ー ス で は あり ませ ん 。 


戻り 値 16 ビ ッ ト 中 に 下記 の よう に 情報 が 返さ れ ま す 。 


ビ ピット 名 前 意味 

15 GPIB ポー ド 0: な し 1: あり 

14 拡張 RS-232C ポー ド 0: な し 1: あり 

13 サウ ンド ボード 0: な し 1: あり 

12 未 使用 

11-08 接続 ドラ イブ 数 0-15 

07-04 クロ ッ ク モ ー ド 0 : 5MHz 3 : 12MHz 
1: 8MHz 4 : 16MHz 
2: 10MHz 

03-01 CPU タイプ 0:8086 2 : 80286 
1: V30 3: 80386 

00 キー ボー ド タ イ プ 0 : 従来 型 1 : 新型 
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す include <bios98 .h> 


void main() 


( 


unsigned flagi 


flag = bios98equip( ): 
if (flag & 0x8000) 
printf("GPTB ボ ー ド が 接続 され て いま す 。 \n"): 
1E (Elag & 0x4000) 
printf(" 拡 張 RS-232C ボ ー ド が 接続 され て いま す 。*n*)i 
1f (flag & 0x2000) 
printf(" サ ウン ド ボ ー ド が 接続 され て いま す 。 *\n*)i 
printE(" ド ライ ブ は zd 台 接続 きれ て いま す 。*\n', 
(flag >> 8) & OxOF ): 
switch (( Elag >> 8 ) & OxOF ) ( 
case 0 : printf("CPU ク ロッ ク は 5MHz で す 。 \n")i 
breaki 
PrintE("CPU ク ロッ ク は 8MHz で す 。\n")i 
breaki 
case 2 : pr1ntf("CPU ク ロッ ク は 10MHz で す 。 \n"): 
breaki 
case 3 : printE("CPU ク ロッ ク は 12MHz で す 。 \n'): 
breaki 
case 4 : printE("CPU ク ロッ ク は 16MHz で す 。*\n") 
breaki 


switch (( Elag >> 1 ) & Ox0007 ) { 
case 0 : printE("CPU タ イプ は 8086 で す 。\n*)i 
breaki 
case 1 : printE("CPU タ イプ は V30 で す 。\n")j 
br 
case 2 : printf("CPU タ イプ は 80286 で す 。 \n*): 
breaki 
printf("CPU タ イプ は 80386 で す 。*\n*): 
br 


if (El1ag & 0x0001 ) 

printf(" キ ー ボ ー ド は 新型 で す 。*\n*)i 
e1se 

Printf(" キ ー ボ ー ド は 従来 型 で す 。*n*): 
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bios98harddisi 


機能 ハー ド デ ィ スク を 操作 し ます 。 


形式 #include <bios98.h> 
unsigned bios98harddisk (HARDDISK_INFO * 42) : 


プロ ト タ イ プ bios98.h 


解説 bios98harddisk は 、 ハー ド デ ィ スク を 直接 制御 する た め の イ ンタ ー フ ェ ー 


ス で す 。 


パケ ッ ト 引 数 7 内 の メン バ cmmd に より 各種 の コマ ンド を 実行 し ます 。 
構造 体 HARDDISK INFO は , bios98.h の 中 で 次 の よう に 定義 され て い 


ます 。 


typedef struct て 


unsigned 
unsigned 
unsigned 
unsigned 
uneigned 
uneigned 
unsigned 
unsigned 


char 
char 
char 
nt 

nt 

char 
char 
char 


) HARDDISK INEO: 


Cmmd 

TH 
device_typi 
data_sizi 
cy1nd_numi 
head_numi 
sector_numi 
*data_buf: 
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DISK コ マン ド */ 

実行 後 の 状態 */ 

デバ イス タイ プ / ユ ニッ ト 番 号 */ 
デー タ サ イズ +*/ 

シリ ンダ 番号 */ 

ヘッ ド 番 号 */ 

セク クタ 番号 */ 

デー タ 域 */ 


643 


戻り 値 各 コ マン ド を 実行 し た 結果 は , 16 ビ ッ ト 中 の 下位 8 ビッ ト に 設定 され 返さ れ 
ます 。 ま た , パケット 内 の メン バ stus に も 格納 され ます 。 


較 パ ケッ ト 内 の デー タ の 授受 


HARDDISK INFO|1 2 4 5 6 7 8 14 15 16 17 
cmmd AH |R R R R R R R R R R R 
stus AH IWWWWWWWWWWW 
device typ| AL |IR R R R R R R R RRR 
data siz |BXBHIR R XRxX R XRxR R X 
cylind num| CX |IR R x R xX R X R R R メ 
head num | DH |IR R xX R X R X R _R R ※ 
sector num| DL |R R X R X R X R R R ※ 
data buf |ESBPIR R X xX xX R X X R _R X 


機能 コー ド (DISK コマ ンド ) は 以下 の よう な 意味 を 持っ て いま す 。 


番号 コマ ンド コー ド 
1 READ DATA OxX6 
2 WRITE DATA OxX5 
4 RECALIBRATE OxX7 
5 FORMAT DRIVE OxYD 
6 INITIALIZE 0x03 
7 VERIFY OxX1 
8 SENSE 0x04 
14 FORMAT TRACK 0xZD 
15 ASSIGN ALTERNATETRACK 0x08 
16 FORMAT BAD TRACK 0x0B 
17 RETRACT OxXF 


644 
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上 の 表 の コー ド 使 われ て いる サ プ コ マン ド (上 位 4 ビ ッ ト ) は 以下 の よう 


な 値 と 意味 を 持っ て いま す 。 
上 位 4 ビッ ト ビ ピット 説明 
XX SS r r 再 試行 指定 
EE 鐘 ェ メ 意味 な し 
2 の |.0 2 
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bios98key 


形式 


プロ ト タ イ プ 


戻り 値 


646 


キー ポー ドイ ンタ ー フ ェ ー ス で す 。 


#include <bios98.h> 
void bios98key(KEY INFO * ん ey) : 


bios98.h 


bios98key は , 入力 待ち もの キー デー タ の 読み 出し , 入力 待ち な し キー デー タ 
の 読み 出し , シフ トキ ー の 押下 チェ ッ ク , キー ポー ドイ ンタ ー フ ェ ー ス の 
初期 化 , グ ルー プ わ けさ れ た キー 配列 の キー 入力 状態 の セン ス な ど を 行 な 
いま す 。 

構造 体 KEY INFO は , bios98.h の 中 で 以下 の よう に 定義 され て いま す 。 


typedef struct 


unstgned char cmmdi /* 機能 コー ド */ 
unsigned char stusi /* 実行 後 の 状態 *+/ 
unsigned char scan_codei /* スキ ャ ンコ ー ド */ 


unsigned char inter_code:  /* 内 部 コー ド */ 

unsigned char shift_code: 。 /* シフ トコ ー ド */ 

unsigned char group_numi /* グル ー プ 番号 */ 

unsigned char group_stusi  /* グル ー プ ビッ ト 情 報 */ 
) KEY_TNEO: 


この 関数 の 実行 中 は , S7OP キー は 完全 に 無視 され る よう に な っ て いま す 。 


機能 コー ド が 0 の と き , 入力 され た キー コー ド を 返し ます 。 16 ビ ッ ト 中 の 上 
位 8 ビ ッ ト は スキ ャ ンコ ー ド で 16 ビ ッ ト 中 の 下位 8 ビッ ト は 内 部 コー ド で す 。 
また , パケ ッ ト 内 の メン バ に も 値 が 格納 され ます 。 

機能 コー ド が 1 の と き , キー が 解放 状態 の と き は 0 を 返し , キー が 押下 状態 
の と き は その キー コー ド を 返し ます 。16 ビ ッ ト 中 の 上 位 8 ビ ッ ト は スキ ャ ン 
コー ド で 16 ビ ピット 中 の 下位 8 ビッ ト は 内 部 コー ド で す 。 また , パケ ッ ト 内 の 
メン バ に も 格納 され ます 。 

機能 コー ド が 2 の と き , シフ トキ ー 提 下 情報 を 返し ます 。 16 ビ ッ ト 中 の 下位 
8 ビッ ト に 下記 の よう に 情報 を 返し ます 。 また , パケ ッ ト 内 の メン バ に も 格 
納 き され ます 。 
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b7 be b5 b4 b3 b2 bl DO 
9| ol ol il il ュ 


ーー SF7 キー 押下 時 

CAPS キー 押下 時 

カナ キー 押下 時 

GRP キー 押下 時 

> C7/ キー 押下 時 

機能 コー ド が 3 の と き , 戻り 値 は 意味 を 持ち ませ ん 。 

機能 コー ド が 4 の と き 。, 変数 group_ num の キー コー ド グ ル ー プ に 対応 する 
ビッ ト 情 報 を 返し ます 。16 ビ ッ ト 中 の 下位 8 ビッ ト は キー の 状態 を 示し て い 
ます 。 ま た , パケ ッ ト 内 の メン バ に も 格納 され ます 。 


較 パ ケッ ト 内 の デー タ の 授受 


KEY INFO 0 
cmmd AH R 
stus BH メ 
scan code| AH W 

W 
3 
X 
X 


inter code| AL 
shift code| AL 
group ml AL 


x X X ぶ 朗 良 記紀 |ー 
XX 計 X XX XX 名 
xX xx XX X 包 oe 
島 5x xxxX 多 | ょ 


group stuS AH 
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例 nclude <bios98.h> 


void man() 

( 
nt ii 
unsigned key,。 eEti 
KEY_INFO kinfi 


kinf.cmmd = 3: 

bios98key(&kinf): /* キー ボー ド の 初期 化 メ +/ 
printf(" キ ー を 押し て くだ さい 。 wm"): 

kinf.cmmd = 0 


key = bios98key(&kinf): /* キー 入力 */ 
kinf.cmmd = 2: 
sft = blos98key(&kinf): /* シフ トキ ー の セン ス */ 


Printf("* ス キャ ンコ ー ド は Z02X,。 内 部 コー ド は 202X で す 。\n*。 
key / 256, key Z 256): 
printf(" シ フト キー 状態 は 702X で す 。 \n"。 sft): 
do ( 
printf(* キ ー セ ンス 中 ,"): 
kinf.cmmd = 1 
key = bios98key(&kinE), /* キー 入力 */ 
) while (key == 0): 
Printf(* ス キャ ンコ ー ド は Z02X。 内 部 コー ド は 702X で す 。 \n"。 
key / 256, key z 256): 
る 0 
do ( 
kinf.cmmd = 4 
kinf.group_num = ii 
key = bios98key(&kinE): /* キー グル ー プ セン ス #*/ 
Printf(" キ ー グ ルー プ z02X。 対応 ビッ ト Z02X\n" 1, key): 
5 
) while (1 < 16): 
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bios98memory 


機能 実装 メモ リ の サイ ズ を 調べ ます 。 


形式 #include <bios98.h> 


unsigned bios98memory (void) : 
プロ ト タ イ プ bios98.h 


解説 bios98memory は , 現在 使用 し て いる シス テム の メイ ン メ モリ サイ ズ を 返 
し ます 。 こ の 関数 は , メモ リス イッ チ (bios98msw を 参照 ) の メモ リサ イ 
ズ を チェ ッ ク す る の で は な く , 実 メ モリ サイ ズ を チェ ッ ク し ます 。 


注記 : この 関数 は BIOS イン ター フェ ー ス で は あり ませ ん 。 
戻り 値 128, 256, 384, 512, 640 の いずれ か を 返し ます 。 単 位 は K バイ ト で す 。 


例 #1nc1ude <bios98.h> 
void main() 
6 
Printf(" シ ステ ム の メモ リ は ZdKb で す 。*n* , blos98memory() ) 
) 
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Dios98mouse 


機能 マウ ス の 制御 を 行ない ます 。 
形式 #include <bios98.h> 


void bios98mouse(MOUSE INFO * 7) : 


プロ ト タ イ プ bios98.h 


解説 bios98mouse は 、 カー ソル 位置 の 取得 、 カ ー ソ ル 位 置 の 設定 、 左 ポタ ン 押 
下 情 報 の 取得 、 左 ポタ ン 解放 情報 の 取得 、 右 ポタ ン 押 下 情報 の 取得 、 右 ポ 
タン 解放 情報 の 取得 、 マ ウス 移動 距離 情報 の 取得 な どの マウ ス の 動作 に 関 
する コマ ンド を 実行 し ます 。 ま た , 環境 の 初期 化 , カー ソル 表示 。 カー ソ 
ル 消 去 な ど は どちら の 関数 で 利用 し て も か まい ませ ん 。 
構造 体 MOUSE_INFO は , bios98.h の 中 で 以下 の よう に 定義 され て いま 


3 

typedef struct ( 
uneianed char cmmdi /* 機能 コー ド ォ / 
unsigned char stusi /* 実行 後 の 状 態 */ 
char 1ft_butoni /* を ボタ ン の 状態 き / 
char rgt_butoni /* 右 ボ タン の 状態 し // 


unsigned int 1ft counti /* を ボタ ン の 押下 / 解 放 固 数 */ 
unstagned 1nt rgt counts /* 右 ボ タン の 押下 / 解 放 固 数 */ 


unstgned int abs_h_ crs: /* カー ソル の 水平 軸 上 座標 者 

unsigned nt abs vcrsi  /* カー ソル の 第 直 軸 座標 ォ / 

nt re1_h_crsi /* カー ソル の 相対 水平 軸 座 標 */ 

nt rel_v_crsi /* カー ソル の 相対 水 直 軸 座標 メ / 
) MOUSE_TNFO: 


注意 : この 関数 は , 日 本 電気 が 提供 し て いる マウ ス ド ラ イ バ を 利用 し て い 
ます 。 し た が っ て 使用 する 場合 は , 必ず CONFIG.SYS に マウ ス ド ラ イ バ 
(MOUSE.SYS) を 組み 込む こん で お いて くだ さい 。 
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戻り 値 あり ませ ん 。 


田 パ ケッ ト 内 の デー タ の 授受 


MOUSEINFO |0 1 2 3 4 5 6 7 8 11 
cmmd AH |R R R R R R R _R R R 
stus AX |IW x X X メメ ペペ ペペ 
lft buton AX |x x x WxWWxx メ 
rgt_buton BX | ベ メメ XX WxXxXWW※X 
1lft count BX |< xx XX XX WWXX※ 
rgt count BX |X XX X XXX WWx 
as_ h crs| CX IX XX W RWWWWx 
abs v crd DX |< xxX WRWWWWx 
rel h crs| CX | ベベ XX メメ XXXXXW 
rel v crs| DX |X X X X XX XXXW 


関連 項目 bios98mouse imit 
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す 1nclude <blos98.h> 
statlc unsgned char mouse_patt[] = ( ...)5 


vold mousefun(nt stus。 1nt 1Et buton。 int rgt_buton, 
unsigned abs_h crs。 unsigned abs vy_crs) ( 
switch (stus) { 
case 1 : /* ..、*/ 


case 2 : 7 キメ / 
ん EEJ// 
7 を 。。。、 す / 
7 を 。。、 き / 
} 
} 
void main() 
{ 


MOUSE_TNTT minti 

MOUSE_TNPO minfi 

mint.cmmd = 0: 

blos98mouse_init(&mint)i /* マウ ス 環 境 の 初期 化 */ 
mint.cmmd = 18: 

mint.plane_num = 1: 

blos98mouse_init(&mint): /* マウ ス 措 写 画面 の 設定 */ 
mint.cmmd = 9 

mint.crs_h_bas = 0i mint.cre_v_bas = 0i 

mint.CrS_pat p = mouse patti 

bios98mouse_1nlt(&mint)i /* カー ソル 形状 の 設定 */ 
mint.cmmd = 15: 

mtnt.md_h_sca = 2: mint.md y sca = 2 

bios98mouse- ま nt て (を mtnt): /* ミッ キー ドッ ト 比 の 設定 */ 
mint.cmmd = 12: 

mint.ca11 cond = Ox1P: 

mint.mouse_fun = mousefunci 

os98mouse_init(&mint): /* 関数 登録 */ 

mtnf.cmmd = 4 

、Hnf.abe_h_crs = 300, minE.abe_y cr = 200』 


blos98mouse(&minf): /* マウ スカ ー ソ ル 位 置 設定 */ 
て SmHnt.cmmd > 1 
blos98mouse_lnit(&mint): /* マウ スカ ー ソ ル の 表示 */ 
mf .cmmd 


bos98mouse(&minf) : /* を ボタ ン 押 下 の 取 得 */ 
ー PrintE( *L=Zd ,LC=Zd 日 =Zd ,V=Zdn* 。 
minf.1ft buton。 minf.1ft count。 


minf.abe_h_crs,。 minE.abe_v_crs): 
ん EE / 
で ーー 
mdnf.cmmd = 8 
bios98mouse(&minf): /* 右 ボ タン 解放 の 取得 */ 


て PrintE("R=Zd。 RC=zd。 HeZd。 Va=zd\n 
mtnf.rgt_buton。 mtnf.rgt count, 
minf.abs_h_cre。 minf、abs_v_crs): 

プ * .. ま / 

mint.cmmd = 2: 


bios98mouse_init(&mint): /* マウ スカ ー ソ ル の 消去 */ 
mint.cmmd = 0i 


bios98mouse_init(&mint): /* マウ ス 環 境 の 初期 化 */ 
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bios98mouse_init 


形式 


プロ ト タ イ プ 


マウ ス の 初期 化 を 行ない ます 。 


#include <bios98.h> 


void bios98mouse_init(MOUSE INIT * 5 


bios98.h 


bios98mouse imnit は 、 カ ー ソ ル 表 示 画 面 の 設定 , 水平 軸 方 向 の カー ソル 移 


動 範囲 の 設定 , 垂直 軸 方 向 の カー ソル 移動 範囲 の 設定 ミ 


ッ キ ー/ ド ッ ト 比 


の 設定 , カー ソル 形状 の 設定 , ユー ザ 定 義 の 割り 込み ルー チン を 登録 な ど 
の 初期 化 に 関す る コマ ンド を 実行 し ます 。 
構造 体 MOUSE INIT は , bios98.h の 中 で 以下 の よう に 定義 され て いま 


す 。 

typedef struct ( 
unsigned char cmmdi /* 機能 コー ド */ 
unsigned char stusi /* 実行 後 の 状 態 / 
uneigned nt plane_num: /* カー ソル の 表示 画面 ォ / 
unstgned 1nt /* カー ソル 水平 軸 の 下限 界 ォ / 
unsigned nt /* カー ソル 水平 軸 の 上 限界 ォ / 
unstgned int /* カー ソル 重 直 軸 の 下限 界 7 
unsigned int /* カー ソル 秋 直 軸 の 上 限界 */ 
unsigned nt /* 水平 軸 の ミッ キー/ ド ッ ト 比 */ 
unsigned nt /* 垂直 軸 の ミッ キー/ ド ッ ト 比 */ 
unsigned int /* マウ スカ ー ソ ル 水 平 軸 の 基点 */ 
unsigned nt _v_1 /* マウ スカ ー ソ ル 番 直 軸 の 基点 */ 
unsigned char *cre_pat /* マウ スカ ー ソ ル の 形状 を 指す */ 
unsigned 1nt ca11 cond, /* 割り 込み 条件 ォ / 
void (*mouse_fun)(): /* 割り 込み 時 に 起動 する 関数 */ 

) MOUSE_TNTT: 


機能 コー ド 12 の "ユー ザ 定 義 の サブルーチン の 登録 "に お いて , ユー ザ 定 義 
の 割り 込み ヘン ドラ を 呼び 出す 形式 は 下記 の 通り で す 。 


Yoid mouse_fun(int 


Btus。 /* 1,2.4.8,16: 原 因 */ 
nt 1Et_buton。  /* 0: 解 放 。 -1: 押 下 */ 
nt rgt_buton,。  /* 0: 解 放 。 -1: 押 下 */ 
unstgned abe_h cre。 /* 0 一 639 */ 


uns1gned abs 


PC-9801 の ROWM-BIOS イ ンタ ー フ ェ ー ス 


7_CrS)i 


NO て 199。H:0 て 399 */ 


653 


654 


この 中 で , N は カラ ー モ ー ド , H は 高 分 解 カ ラー モー ド を 表わし ます 。 
な お ,、 ユー ザ 定 義 の 関数 内 で 実行 で きる 処理 は 下記 の よう な 制約 を 受け ま 
す 。 


一 DOS シス テム コー ル を 発行 し て は いけ ませ ん 。DOS シス テム コー ル 
を 処理 中 で な けれ ば か まい ませ ん (C 標準 ライ プラ リ , C 非 標準 ライ ブ 
ラリ の 関数 は これ ら を 使用 し て いる も の が ある の て 充分 注意 し て くだ 
さい )。 

還 ROM-BIOS コー ル は で きる だ け 使 用 を 避け て くだ さい 。 

圏 タイ ニ ィ スモ ー ル ,、 ミディ アム モデ ル で は 自動 (auto) の 配列 や 構 
造 体 は 使用 し て は いけ ませ ん 。 これ は , 割り 込み が 発生 する タイ ミン 
グ は 常に ユー ザ 定 義 の プロ グラ ム が 稼働 し て いる と きだ け で は な く , 
シス テム 側 の タス ク (最小 単位 の 意味 ある 処理 工程 ) が 起動 し て いる 
と き で も 発生 する か ら で す 。 
割り 込み が シス テム 側 の タス ク 内 で 発生 し た と き は ,。 スタ ッ ク セ グ メ 
ント (SS) が シス テム 側 の 領域 を 指し て いる た め 不 具合 が 生じ ます 。 
タイ ニ ィ , スモール, ミ ディ アム モデ ル で は DS,ES,SS セグ メン トレ ジ 
スタ は 常に 同一 領域 を 示し て いな けれ ば な ら な いと いう 規則 が あり ま 
す 。 DS,ES セグ メン トレ ジス タ に 関し て は ユー ザ 定 義 の 割り 込み ハン 
ドラ に 制御 を 渡す 前 に , ユー ザ 定 義 の プロ グラ ム 側 の 領域 を 指す よう 
に し て あり ます 。 静 的 (static) 変数 、 単独 の 自動 (auto) 変数 は 利用 
で きま す 。 

な お , コン パク ト , ラー ジ 、 ヒ ュー ジ モ デ ル で は こう し た 制約 な し で 
利用 で きま す 。 

一 setjmp, longjmp は 使用 で て きま せん 。 

罰 割 り 込み ハン ドラ が 使用 する スタ ッ ク は ,。 シス テム 側 の スタ ッ ク か 利 
用 者 側 の スタ ッ ク か 解ら な い の で , 関数 の 呼び 出し の ネス ト を 深く し 
な いよ うに し て くだ さい 。 
また , コン バイ ル の 際 に は , スタ ッ ク オ ー バ パー フロ ー チ ェ ッ ク の オォ プ ブ 
ショ ン (-N) は つけ な いで くだ さい 。 


この 機能 コー ド の 使用 に 関し て , 利用 者 が 作成 し た プロ グラ ム を 終了 させ 
る と き に は , 再度 マウ ス 環境 を 初期 化し を けれ ば な り ま せん 。 初期 化し て 
お か な いと ,。 プロ グラ ム 終 了 後 ,。 マウ ス に 触れ た だ け で シス テム が 凌 走 す 
る の て 注意 し て 使っ て くだ さい 。 
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注意 : この 関数 は , 日 本 電気 が 提供 し て いる マウ ス ド ラ イ バ を 利用 し て い 
ます 。 し た が っ て 使用 する 場合 は , 必 ら ず CONFIG.SYS に マウ ス ド ラ イ バ 
(MOUSE.SYS) を 組み 込む こん で お いて くだ さい 。 

戻り 値 あり ませ ん 。 


圏 パ ケッ ト 内 の デー タ の 授受 


MOUSE_ INIT 0 1 2 9 12 15 16 17 18 
cmmd AH |R R R R R R R R R 
stus AX |IW X X X X X XX XX 
planenum| BX |< メメ XX XXX XR 
minhpos| CX |X XX X X X R X メ 
max hpos| DX |X X X X X X R X メ 
minvpos| CX |X X X X X X X R X 
max vpos| DX |X X X X X X X R X 
mdhscall| CX |X X X X X R XX メメ ※ 
mdvscal| DX | メ X X X X X R XX ※ 
crs hbas | BX |X X X R XX XX メメ 
crsvbas | CX |X X X R XX メメ ズ メ 
crs pat p IESDXIX X X R X X X X X 
call cond | CX |X X X X R X X X X 
mouse_fun |ESDXIX X X X R X X X X 

関連 項目 bios98mouse 

例 bios98mouse を 委 照 し て くだ さい 。 
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pbios98msw 


機能 メモ リス イッ チ 情 報 を 得 ます 。 


形式 #include <bios98.h> 
unsigned bios98msw (MSW_INFO * zasw) : 


プロ ト タ イ プ bios98.h 


解説 bios98msw は , PC-9801 シ リー ズ 上 の メモ リス イッ チ 情 報 の 読み 出し , 更新 
を 行ない ます 。 更新 の 際 に は , 本 体 の アディ ッ プ スイ ッ チ SW2 の 5 が ON に 
な っ て いる 必要 が あり ます 。 SW2 の 5 が OFF に な っ て いる と , 本 体 の 電源 
を 再 投入 し た と き に メモ リス イッ チ が 初期 化 さ れ て し まう た め , メモ リス 
イッ チ へ の 書き 込み を 行なっ て も 情報 が 失わ れ て し まい ます 。 
引数 sw_ mum に は 1 一 6 の 整数 を 指定 し 、 それぞれ メ モリ スイ ッ チ の 
SW1-SW6 に 対応 し ます 。 
構造 体 MSW_INFO は , bios98.h で 以下 の よ うに 定義 され て いま す 。 


typedef struct 人 


uns1gned char cmmdi /* 機能 コー ド */ 
unsigned char stuei /* 実行 後 の 状 態 二 
nt sw_numi /* メモ リス イッ チ 番 号 ォ / 
unsigned char value /* メモ リス イッ チ の 内 容 */ 
) MSW_TNEOi 


機能 コー ド 1 は 指定 し た メモ リス イッ チ の 読み 出し , 機能 コー ド 2 は 指定 し 
だ た メモ リス イッ チ の 書き 出し に な り ま す 。 


注記 : この 関数 は BIOS イン ター フェ ー ス で は あり ませ ん 。 
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戻り 値 機能 コー ド が 1 の と き , 指定 され た メモ リス イッ チ 情 報 を 返し ます 。 ま た , 
パケ ッ ト 内 の メン バ に も 格納 され ます 。 
機能 コー ド が 2 の と き , 引数 value の 値 を 返し ます 。 sw_num の 値 が 不正 な 
と き は -1 を 返し ます 。 


田 パ ケッ ト 内 の デー タ の 授受 


MSW_INFO 


cmmd 


Stus 


レ ・ 且 し ・ 有 3 導 ・ ぶ 】 


1 

R 

メ 

SWw_num R 
W 


Value 


例 #1nclude <bios98.h> 
vold main() 
{ 
unsigned etusi 
nt 昌 
MSW_TNEO minfi 


for (は =1: 1 <m 6i 1 人 +) 人 
minf.cmmd = 1: 


stus /* 読み 出し */ 
PrintE("SWZd = Z02X.\n"。 1。 stus)i 

} 

mtnf.cmmd = 2 

minf.sw_num = 6: 

minf.yalue = 0x14i 

stus = bios98msw(&minf): /* 書き 込み */ 

PrintE("SW6 = Z02X.gn"。 stus): 
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bios98print 


機能 プリ ンタ イシ ター フェ ー ス で す 。 


形式 #include <bios98.h> 
unsigned bios98print (PRINT INFO * 7) : 


プロ ト タ イ プ bios98.h 
解説 bios98print は 、 プ リン タコ ント ロー ラ の 初期 化 , プ リン タス テー タス の 取 


得 , 1 文字 単位 の 出力 , 文字 列 単位 の 出力 に 使用 し ます 。 
構造 体 PRINT INFO は , bios98.h の 中 で 以下 の よう に 定義 され て いま 


す 。 

typedef struct ( 
unsigned char cmmdi /* 機能 コー ド 7/ 
unsigned char stusi /* 実行 後 の 状 態 // 
unstgned char chri /* 出力 文字 ku 
unstgned char *stringi /* 出力 文字 列 を 指す ポイ ンタ */ 
uneslgned char *stringi /* 出力 サイ ズ も 7 

}) PRINT_INEOi 

戻り 値 機能 コー ド が 16 お よび 18 の と き は , 16 ビ ッ ト 中 の 下位 1 ビット に , プリ ン 


タ に 対し て 送信 可能 か どう か の 状態 を 返し ます 。 ま た , パケ ッ ト 内 の メン 
バ に も 格納 され ます 。 


b7 b6 b5 b4 b3 b2 bl b0O 
xlxlxlx xlx|x|i 


ーー プリ ンタ へ の 送信 が 可能 


658 第 2 章 Turbo C ラ イブ ラリ 


機能 コー ド が 17 の と き は ,16 ビ ッ ト 中 の 下位 2 ビッ ト に プリ ンタ へ の 送信 状 
態 を 返し ます 。 ま た , パケ ッ ト 内 の メン バ に も 格納 され ます 。 


b7 b6 b5 b4 b3 b2 bl b0 
xlxlx|x xx 1 | 1 


La 次 デー タ 送 信 可 能 
タイ ム ア ウ ト , 現 デ ー タ 未 送信 


機能 コー ド が 48 の と き は , ビッ ト b1 に タイ ム ア ウ ト 情 報 を 返し , 正常 終了 
の と き は , パケ ッ ト 内 の メン バ string お よび メン バ size は 不定 と な り ま 
す 。 タ イム アウ ト 時 に は メン バ string に 未 送信 の デー タ の 先頭 アド レス を 
返し , メン バ size に 未 送信 の デー タ 長 を 返し ます 。 


b7 b6 b5 b4 b3 b2 bl bO 


xx x|x|x|x 1|x 


タイ ム ア ウ ト 時 
圏 パケ ント 内 の デー タ の 授受 

PRINT INFO 16 1 18 48 
cmmd AH R R R R 
stus AH W_ WW _W WW 
chr AL ※ R メ % 
string ESBX | ※ 3 ※ 。 RW 
size CX 3 メ X 。 RW 
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例 #1nclude <bios98 .h> 
void main() 
{ 
unsigned StatuSi 
PRTNT_INEO pinfi 


PinE.cmmd = 16: 
status = bios98print(&pinf)i 
/* プリ ンタ コン トロ ー ラ の 初期 化 */ 

1f ( ! (status & 0x01)) ( 

printf(" プ リン タ の 準備 を し て くだ さい 。w\n'): 

Pinf.cmmd = 18i 

status = bios98print( &pinf): 

/* プリ ンタ ステ ー タ ス の 取得 */ 


do ( 
PinE.cmmd = 17: 
PinE.chr = "Ai 
status = bios98print(&pinf): /* 1 文字 出力 */ 
1f ( | (status & Ox01) ) 
printf(" プ リン タ の 電源 を 入れ て くだ さい 。\n")i 
1f (status & 0x02) 
printE(* 用 紙切れ 準備 中 ハー ド エ ラ ー。\n*)j 
) while (status != 0x01)』 
PinE.cmmd = 48: 
Pinf、string = "ABCDE"i 
pinf.size = 5: 
status = bios98print(&pinE)i /* 文字 列 出力 */ 
1f (status & Ox02) ( 
printf(" タ イム アウ ト が 発生 し まし た 。 *n"): 
printf("Zs の 文字 列 が Xd バ イト 分 未 送信 で す 。 *\n*。 
Pinf.string, pinf.size): 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


bios98stoptimer 


機能 割り 込み ハン ドラ を 切り 放し ます 。 


形式 Yoid bios98stoptimer (Void)・ 


プロ ト タ イ プ bios98.h 


解説 bios98stoptimer は 、 ユ ー ザ プロ グラ ム を 終了 する 際 に , bios98timer に よ 
っ て イン スト ー ル され た 割り 込み ヘン ドラ を 強制 的 に 切り 放す と き に 使用 
し ます 。 
親 プ ロ セ ス や 子 プ ロ セ ス で 同時 に タイ マ 割 り 込み を 使用 し た 場合 、 ブ ログ 
ラム の 動作 は 保証 され ませ ん 。 
タイ マ 割 り 込 み ハ ンド ラ に つい て は , bios98timer の 解説 を 参照 し て くだ 
さい 。 

戻り 値 あり ませ ん 。 


関連 項目 bios98timer 


例 bios98timer を 参照 し て くだ さい 。 
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bios98time 


機能 日 付 時 刻 の 読み 出し お よび 設定 を 行ない ます 。 


形式 #include <bios98.h> 
void bios98time(TIME INFO * 2) ・ 


プロ ト タ イ プ bios98.h 


解説 bios98time は 日 付 時 刻 の 読み 出し , 日 付 時 刻 の 設定 を 行ない ます 。 
構造 体 TIME INFO は , bios98.h の 中 で 以下 の よう に 定義 きれ て いま す 。 


typedef struct ( 


unsigned char cmmdi /* 機能 コー ド */ 
unsigned char stusi /* 実行 後 の 状 態 */ 
unsigned char yeari /* 年 BCD コ ー ド 00<99 */ 
uns1gned char month weeki  /* 月 , 曜 日 2 進数 1 ン 12, 0 ご 6 */ 
unsigned char dayi /* 日 BCD コ ー ド 01 て 31 */ 
unsigned char houri /* 時 BCD コ ー ド 00 て 23 */ 
uns1gned char mtnutei /* 分 BCD コ ー ド 00 へ 59 */ 
unsigned char secondi /* 秒 BCD コ ー ド 00 て 59 */ 
) TTME_TNFO: 
戻り 値 あり ませ ん 。 


田 パ ケッ ト 内 の デー タ の 授受 


TIME INFO 0 
cmmd AH R R 
stus ※ X 
year W R 
month week W R 
day W R 
hour W R 
minute W R 
second W  R 
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例 すま 1nclude <blos98 .h> 


#define BCDtoB(x) ( (x / 16) * 10+ (xzZ16) ) 
#define BtoBCD(x) ( (x / 10) * 16+ (zz 10) ) 
#define GETupr(x) (x/16) 
ま define GET1wr(x) (xZ16) 
static char *toJPN[ ] 
EE も PE 上 FE 15 上 も 邊 
Yoid main() 


{ 
TTME TNEO tinfi 
int Yaluei 


tinf.cmmd = 0i 
blos98t1me( &tinf): 


/* 現 日 付 時 刻 の 取得 */ 


Printf(* 現 日 付 は 7d 年 7d 月 zd 日 (ze) Zd 時 Zd 分 Zd 秒 \n' 
BCDtoB(t1nf.year) 。 GETupr(tinf.month_week) , 


BCDtoB(tinf day) 。 


toJPN[GET1wr(tinf.month_ week) ] , 


BCDtoB(tinf .hour ) 。 BCDtoB(tinf .minute ) 。 
BCDtoB(tinf.second) ): 
1f (BCDtoB(tinf.second) < 30) 
tinf.second = BtoBCD(0): 


else { 


tinf.second = BtoBCD(0): 


Va1u 
1f (value < 60) 


BCDtoB(tinf.minute) + 15 


tinf.minute = BtoBCD(value): 


else ( 


tnf.minute = BtoBCD(0): 
Yalue = BCDtoB(tinf.hour) + 1』 


1f (value < 24) 


tlnf.hour = BtoBCD(value): 


else ( 


tinf.hour = BtoBCD(0): 
Yalue = BCDtoB(tinf.day) + 1: 


} 
} 
} 
tnf.cmmd = 1: 
blos98time(&tinf): 


/* 日 付 時 刻 の 設定 */ 


Printf(" 秒 針 を 補正 し まし た 。\n") 
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bios98timer 


形式 


関連 関数 


プロ ト タ イ プ 


664 


イン ター バル タイ マー イン ター フェ ー ス 

Yoid bios98timer (unsigned zervg/ Zzze、 void (* 72zer /&c) () ): 
void bios98stoptimer (void) : 

bios98.h 


bios98timer は 。 イン ター バル タイ マ の 設定 と 割り 込み ルー チン の 設定 を 
行ない ます 。 イ ンタ ー バ ル 時 間 eryg/ ze は , 10msec 単位 で 指定 し て く 
だ さい 。 指 定時 間 後に 7 み zer /&zc を 1 回 だ け 呼 び 出し ます 。 連 続 し て 割り 込 
み を 発生 さき せる と き は , zer kzc 内 で bios98timer を 呼び 出し , 自分 自 
身 を 再度 登録 し を お し ます 。 

ユー ザ 定 義 の zer /kzc の 呼び 出し 形式 は 次 の よう に な り ま す 。 


Yold timer func(void): 


ユー ザ 定 義 関数 内 で 実行 で きる 処理 は 以下 の よう な 制約 を 受け ます 。 


田 MS-DOS シス テム コー ル を 発行 し て は いけ ませ ん 。 MS-DOS シス テ 
ムコ ー ル を 処理 中 で な けれ ば か まい ませ ん (C 標準 ライ プラ リ , C 非 標 
準 ラ イプ ラリ の 関数 は これ ら を 使用 し て いる も の が ある の て 充分 注意 
し て くだ さい )。 

 ROM-BIOS コー ル は で きる だ け 使 用 を 避け て くだ さい 。 

田 タ イニ ィ , スモ ー ル , ミディ アム モデ ル で は 自動 属性 (auto) の 配列 
や 構造 体 は 使用 し て は いけ ませ ん 。 これ は , 割り 込み が 発生 する タイ 
ミン グ は , ユー ザ 定 義 の プロ グラ ム が 稼働 し て いる と きだ け で は な く , 
シス テム 側 の タス ク (最小 単位 の 意味 ある 処理 工程 ) が 起動 し て いる 
と き で も 発生 する か ら で す 。 
割り 込み が シス テム 側 の タス ク 内 で 発生 し た と き は , スタ ッ ク セ グ メ 
ント (SS) が シス テム 側 の 領域 を 指し て いる た め 不 具合 が 生じ し ます 。 
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タイ ニ ィ , ス モー ル , ミディ アム モデ ル で は DS,ES,SS セグ メン トレ ジ 
スタ は 常に 同一 領域 を 示し て いな けれ ば な ら な いと いう 規則 が あり ま 
す 。 DS,ES セグメント レジ スタ に 関し て は ユー ザ 定 義 の 割り 込み ハン 
ドラ に 制御 を 渡す 前 に , ユー ザ 定 義 の プロ グラ ム 側 の 領域 を 指す よう 
に な っ て いま す 。 静 的 (static) 変数 単独 の 自動 (auto) 変数 は 利用 
で きま す 。 

な お , コン パク ト , ラー ジ ,。 ヒュ ー ジ モデ ル で は こう し た 制約 な し で 
利用 で きま す 。 

田 setimp,、longjmp は 使用 で きま せん 。 

田 割 り 込 み ハ ンド ラ が 使用 する スタ ッ ク は 。 シス テム 側 の も の か ユー ザ 
側 の も の か は 解ら な い の で , 関数 の 呼び 出し ネス ト を 深く し な いよ う 
に し て くだ きい 。 
また , コン パイ ル の 際 に は 、 スタ ッ ク オ ー バ パー フロ ー チ ェ ッ ク の オォ オプ 
ショ ン (-N) は つけ な いで くだ さい 。 


ユー ザ 定 義 の プロ グラ ム を 終了 する 際 に , 割り 込み ハン ドラ を 強制 的 に 切 
り 放 す に は , bios98stoptimer を 使用 し ます 。 


戻り 値 あり ませ ん 。 


関連 項目 bios98stoptimer 


PC-9801 の ROWM-BIOS イ ンタ ー フ ェ ー ス 665 


666 


#1include <bios98 .h> 
static int clocks 
static nt delay_oni 


Yoid timefunc() 
{ 

c1ock++』 

bios98timer(100, timefunc): 
) 


Yold delayfunc( ) 
{ 


de1ay_on++: 
} 


void delay(unsigned mil11iseconds) 


( 
delay_on = 0i 


/* ュ ] 秒 カウ ンタ */ 
/* 再度 , 1 秒 後 に 割 込 発 生 */ 


bios98timer( mi11iseconds / 10, delayfunc): 


while(1) 
if (delay_on > 0) breaki 
} 


volid main() 
( 
clock = 0 
bios98timer(100, timefunc)i 
while (1) ( 
Printf("Zu。" 。 cock)s 
1E (clock > 1000) breaki 
} 
bios98stoptimer(): 
だ oo7 
de1ay(10000): 
7 ーー・ ォ / 


/* 1 秒 後に 割 込 発生 */ 


/* 割り 込み 停止 */ 
/* 10 秒 間 休 み */ 
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getfont 


機能 ROM の フォ ント パタ ー ン を 読み 出し ます 。 


形式 Yoid getfont(unsigned int code, zzsge cg7 玉 /O77) : 


プロ ト タ イ プ dosh 


機能 説明 getfont は 、 マシ ン の ROM に 組み 込ま れ て いる フォ ント バ パターン を 読み 
出し ます 。 引 数 coe で 指定 され た コー ド に 対応 する フォ ント ピット イメ 
ー ジ を バッ ファ 76z7 に 格納 し ます 。 
引数 7pgr の レイ アウ ト は 次 の よう に な り ま す 。 


最大 32 バ イト 
の ② @|@ @⑧1@ 回 回 図 基 
各 1 バ イト 
ーーーww バイ トーーー、 
① @ 
③ の 
hhx8 記 @ 
バイ ト 


hh : フォ ント の 高き ww: フォント の 幅 
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バッ ファ サイ ズ の 最大 長 は 34 バ イト で す 。 また , 引数 code は 大 の よう な 形 


式 で す 。 
引数 coge 文字 高 さ 幅 引数 76z7 
土 位 8 下位 8 タイ プ hh ww サイ ズ 
Ox80 ANKc HCRT 2 出 18 
Ox00 ANKc NCRT 1 1 10 
shift-JISc 全角 2 2 34 
Ox29 OxXX 半角 2 1 18 
0x2A OxXX 半角 2 1 18 
Ox00 ANKc 1/4 角 1 1 10 


HCRT : 高 解像度 CRT 
NCRT : 標準 CRT 
ANKc : 8 ビッ ト JIS コー ド 
shift-JISc: シフ ト JIS コー ド 
OxXX : 有効 な 8 ビッ ト JIS コー ド 
この 関数 は , PC-9801 の CRT-BIOS を 使用 し て いま す 。 
戻り 値 あり ませ ん 。 


可 搬性 この 関数 は PC-9801 シ リー ズ で の み 動 作 し ます 。 


関連 項目 putuserfont 
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例 #define HH gb[O]*8 
#define ww gb[1] 
#define FT(x) gb[2+ (x)] 


Yold main() 
{ 


nt は 。w。 hi 
unsigned char gb[64]: 
getfont(0xEB9F, gb) /* フォ ント の 読み 出し ょ / 
for ( h =0i h < HHi ht++ ) { 
PrintE( "Z02X"。h): /* 行 番号 の 表示 */ 


for (w= Oi w<Wwi wt+) て 
for (エー0: 1 <8i 4+ ) て 
1f (((FT(h*WW + w) << 1) & 0x0080) == 0x0080) 


PrintE(" 欠 いう) /* ビッ ト オ ン の 表示 */ 
else 
printE("OY): /* ビッ ト オ フ の 表示 */ 


}) 
} 
Printf( "Wn")i 
} 


PC-9801 の ROM-BIOS イ ンタ ー フ ェ ー ス 669 


putuserfont 


機能 ユー ザ フ ォ ント バター ン を 定義 し ます 。 


形式 void putuserfont (unsigned int code、 unsigned char * /oz7) : 


プロ ト タ イ プ dosh 


機能 説明 putuserfont は 、 ユ ー ザ が 作成 し た フォ ント パタ ー ン を マシ ン の フォ ント 
専用 RAM に 定義 し ます 。 定 義 で きる 文字 の 大 き さ は 全角 の み で す 。 引 数 
c9ge で 指定 され た コー ド に 対応 する フォ ント 専用 RAM に , バッ ファ /6zr 
内 の フォ ント ビッ トイ メー ジ を 格納 し ます 。 
引数 pg7 の レイ アウ ト と フォ ント 領域 の 関係 は 次 の よう に な り ま す 。 


ーー/o77 
」 32 バ イト 
mlalolelelelele- 上 上 
各 1 バ イト 
ンーーー ジ クベ イト ーー 
| ①⑤ | @ 
③ MO) 

16 バ イト 6 @ 

dd: ダミ ー 
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引数 cod@ は シフ ト JIS コー ド て で 指定 し ます 。 ユ ー ザ が 定義 で きる コー ド 
の 種類 は 機種 ご と に 異な り 、 次 の と お り で す 。 


マシ ンタ イプ JIS シフ ト JIS 


UV/VF/VM Ox7621 一 0x767E OxEB9F-OxEBFC 
0x7721 一 0x777E OxEC40 一 OxEC9E 
E/F/U2 Ox7621 一 Ox765F OxEB9F-OxEBDD 


この 関数 は PC-9801 の CRT-BIOS を 使用 し て いま す 。 


戻り 値 あり ませ ん 。 


可 搬性 この 関数 は PC-9801 シ リー ズ で の みろ 動作 し ます 。 た だ し PC-9801 の 最初 期 
型 で は 動作 し ませ ん 。 


関連 項目 getfont 


例 stattc unsigned char fontp[] = { 
0x00, 0x00, 
0xff 。 0xff。 0xfE。 Oxff。 0x80。 Ox80。 0x80, 0x80, 
0x80, 0x80, 0x80, Ox80。 Ox80, Ox80, 0x80。 0x80, 
Ox80, 0x80, 0x80, 0x80, 0x80, 0x80, Ox80, 0x80, 
0x80, 0x80, 0x80, 0x80, 0x80。 0x80, Oxf。 OxfE 
})j 


Yod matn() 

{ 
putuserfont(OxEB9F。 Eontp) : /* フォ ント の 定義 */ 
/* . ォ / 


PC-9801 の ROM-BIOS イ ンタ ー フ ェ ー ス 671 


IBM PC の ROM-BIOS イン ター フェ ー ス 


IBM PC 用 ROM-BIOS イン ター フェ ー ス ルー チン は , マシ ン の ROM チッ プ に 組み 込 
まれ て いる ハー ドウ ェ ア 基 本 制御 レー チン を 駆動 する た め の イ ンタ ー フ ェ ー ス ルー チン 
で す 。 こ れ ら の 関数 を 使用 すれ ば , マシ ン の 機能 を 最大 限 に 引き 出す こと が で きま す 。 
た だ し , 他 機 種 と の 互換 性 は まっ た く な い の で , 可 搬 性 の ある プロ グラ ム を 作成 し よう 
と する の で あれ ば , この イン ター フェ ー ス は 使用 すべ き で は あり ませ ん 。 ここ で 説明 
する すべ て の 関数 は 、IBM PC シリ ー ズ で の み 使 用 する こと が で きま す 。 


bioscom 
機能 シリ アル 1/O を 操作 し ます 。 
形式 int bioscom(int cz の , char g の yre、 int po/7) : 


プロ ト タ イ プ biosh 


解説 bioscom は , por7 に 与え られ た 1I/O ポー ト を通して, さま ざま な RS.-232 コ 
ミュ ニケ ーション を 行ない ます 。 
por7 の 値 0 は COM1 に , 値 1 は COM2 に , と いう よう に 対応 し て いま す 。 
ez の の 値 は 、 以 下 の い ずれ か に な り ま す 。 


コミ ュ ニ ケー ショ ン パ ラメ ー タ を g の yze の 値 に セッ ト し ます 。 
g の ye 中 の 文字 を 通信 回 線 を 通し て 送信 し ます 。 

通信 回 線 か ら 1 文字 を 受信 し ます 。 

コミ ュ ニ ケー ショ ン ポ ー ト の 現在 の ステ ー タ ス を 返し ます 。 


の らら ビ の ら 


9 の yre は , 以下 の ビッ ト の 組み 合わ せ で す ( 各 グ ルー プ 中 か ら 1 つ の 値 が 選 
択 さ れ ま す )。 


672 第 2 章 Turbo C ラ イブ ラリ 


0x02 ゲー ダビ w が 0x00 110 ポ ー 


0x03 デー タク ビット ト 8 0x20 150 ボ ポー 

0x40 300 ポ ー 
0x00 スト ッ プ ビッ ト 1 Ox60 600 ポ ー 
0x04 スト ッ プ ビッ ト 2 Ox80 1200 ボ ー 

OxA0 2400 ボ ポー 
0x00 ノー パリ ティ OxC0 4800 ボ ポー 
0x08 奇数 パリ ティ OxE0 9600 ポ ボー 


Ox18 偶数 パリ ティ 


た と えば , g の ye に OxEB(OxE0 | 0x08 |0x00 10x03) を 与え る と , コミ ュ 
ニケ ーション ポー ト に , 9600 ポ ー, 奇数 パリ ティ , スト ッ プ ビッ ト 1, デー 
タビ ッ ト 8 を セッ ト す る こと に な り ま す 。 bioscom は , BIOS 0x14 割 り 込み 
を 使用 し ます 。 


戻り 値 ez の の すべ て の 値 に 対し て , bioscom は 16 ビ ッ ト 整 数 を 返し ます 。 こ の う 
ち , 上 位 8 ビ ッ ト は ステ ー タ ス で , 下位 8 ビッ ト は ey の 値 に よっ て 変化 し 
ます 。 戻 り 値 の 上 位 8 ビ ッ ト は 次 の よう に 定義 きれ て いま す 。 


ビッ ト 15 タイムアウト 

ビッ ト 14 トラ ンス ミッ トシ フト レジ スタ が 空 
ビッ ト 13 トラ ンス ミッ ト ホ ー ル ドレ ジス タ が 空 
ビッ ト 12 プレ ー ク を 検出 

ビッ ト 11 フレ ー ム エラ ー 


ピット 10 パリ ティ エラ ー 
ビッ ト 9 オー バー ラン ェ エラー 
ビッ ト 8 。 デー タレ ディ 


gpyze の 値 が 送信 で き な か っ た 場合 は , ピット 15 が モッ ト さ れ ま す 。 そ う で 
な い 場 合 に は , 残り の ビッ ト お よび 下位 8 ビッ ト は 適切 な 値 に セッ ト され ま 
まぁ 

ez の の 値 が 2 (受信 ) の 場合 、 エ ラー が な けれ ば , 読み 込ま れ た バイ ト は 戻 
り 値 の 下位 ビッ ト に あり ます 。 エラ ー が あっ た 場合 は 、 上 位 8 ビ ッ ト 中 の 少 
な く と も 1 つが セッ ト さ れ ま す 。 上位 8 ビ ッ ト が どれ も セッ ト さ れ て いな け 
れ ば , その バイ ト は エラ ー な し て 受信 され た こと に な り ま す 。 
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ez の の 値 が 0 また は 3 の 場合 、 戻り 値 の 上 位 8 ビ ッ ト は 上 の 定義 通り に セッ 
ト さ れ 、 下位 8 ビッ ト は 以下 の よう に 定義 され ます 。 


ビット 7 受信 済み 回 線 信号 を 検出 

ビット 6 リン グイ ンジ ケー タ 

ビッ ト 5 デー タ セ ッ ト レ ディ 

ビッ ト 4 クリ アト ゥ ー セ ンド 

ビッ ト 3 受信 回 線 信号 中 の 変更 検出 子 
ビッ ト 2 トレ ー リ ング エッ ジリ ング 検出 子 
ビッ ド 1 デー タモ セッ トレ ディ 中 の 変更 
ビッ ト 0 クリ アト ゥ ー セ ンド 中 の 変更 


可 搬 性 bioscom は IBM PC と その 互換 機 で の み 動 作 し ます 。 


例 nclude <blos.h> 
#Hnc1ude <conio.h> 


#define COM1 0 
#define DATA_READY Ox100 

/* 1200 ボ ー, 7 ビ ピット, 1 スト ッ プ ノー バリ ティ 4/ 
#*define SETTTNGS (Ox80!0x021Ox00!0x00) 


main() 
6 
1nt reglster 1n。 out。 statusi 


bioscon(0, SETTTNGS, COM1 ) 
cprint("... BTOSCOM [ESC] to exit .….\n'): 
while (1) 
{ 
status = bioscon(3。 0。 COH1): 
1f (status & DATA_READY) 
if ( (out = bioscom(2。 0, COM1) & Ox7F) != 0 ) 
putch(out) : 
if (kbhit()) 
{ 
3f ( (in = getch()) == "wc18 り 
return(0)i 
bioscom(1。 in。COM1): 
} 
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Diosdisk 


形式 


プロ ト タ イ プ 


BIOS の ディ スク サー ビス で す 。 


int biosdisk (int cz の 、 int の je、int が eg の 。 int gc。 
int secor、 int sec な void *※ が 77e/) : 


bios.h 


biosdisk は 、 割り 込み 0x13 を 使用 し て ディ スク の 操作 を BIOS に 直接 指示 
1 k の 

の み zve は 、 ど の ドラ イブ を 使用 する か を 指定 する 数 値 で す 。 0 が 1 番目 の フロ 
ッ ピ イィ ドライブ , 1 が 2 番目 の フロ ッ ピ イィ ドライブ , 2 が 3 番目 の フロ ッ ピ ィ 


ドラ イプ ,・・・・・ と な り ま す 。 ハ ー ド ディ スク に つい て は , の ie の 値 
Ox80 が 1 番目 の ドラ イブ , 0x81 が 2 番目 、 0x82 が 3 番目 ,・・・・・ を 指定 す 
る こと に な り ま す 。 


ハー ド デ ィ スク に 対し て は 、 ディ スク の パー ティ ショ ン で は な く , 物理 ド 
ライ ブ を 指定 し ます 。 必 要 で あれ ば , ユー ザ プ ロ グラ ム 側 で パー ティ ショ 
ン テ ー ブ ル を 読み 換え な けれ ば な り ま せん 。 

ez の は 、 実 行 する 操作 を 示し ます 。cw の 値 に よっ て , 他 の パラ メー タ が 
必要 か そう で な いか が きま り ま す 。 

以下 に 示し た の は , IBM PC, XT, AT PS/2.。 あ るい は それ ら の 互換 機 
に お いて 有効 を cz の 値 で す 。 


0 ディ スク シス テム を リセ ッ ト し ます 。 ド ライ プ コ ント ロー ラ を 強制 
的 に ハー ドリ セッ ト さ せま す 。 他 の パラ メー タ は すべ て 無視 され ま 
す 。 

1 前 回 の ディ スク 操作 の ステ ー タ ス を 返し ます 。 他 の パラ メー タ は す 
べ て 無視 され ます 。 

2 1 つ 以 上 の ディ スク セク タ を メモ リ に 読み 込み ます 。 読 み 込む 先頭 
の セク タ は , ん eg の , か gc ん , secfo7 に よっ て 与え られ ます 。 セク タ 数 
は zsecfs で 与え られ ます 。 デ ー タ は , 1 セク タ 512 バ イト で , Zx77ez 
に 書き 込ま れ ます 。 
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1 つ 以 上 の ディ スク セク タ に メモ リ か ら 書 き 込 み ま す 。 書き込む 先 
頭 の セタ クタ は , eg の, gc ん , secror に よっ て 与え られ ます 。 セ クタ 
数 は xsecs で 与え られ ます 。 デ ー タ は ,1 セ クタ 512 バ イト で , が 7ey 
か ら 書 き 込 まれ ます 。 

1 つ 以 上 の モク タ を ベリ ファ イ し ます 。 開 始 セ クタ は , Aegg, 
gc ん 、 secror に よっ て 与え られ ます 。 セ クタ 数 は zsecs で 与え られ 
まま 

1 つの トラ ッ ク を フォ ー マ ッ ト し ます 。 ト ラッ ク は , egg の と か gc ん 
に よっ て 与え られ ます 。 7e は , 指定 され た トラ ッ ク 上 に 書き 込 
まれ る セク タ ベ ヘッ ダ の テー ブル を 指し ます 。 こ の テー ブル お よび フ 
ォ ー マ ッ ト 操 作 の 詳細 に つい て は , IBM PC の テク ニカ ルリ ファ レ 
ンス マニ ュ ア ル を 参照 し て くだ さい 。 


以下 に 示し た の は , IBM XT, AT, PS/2,、 あ るい は それ ら の 互換 機 に お 
いて の みろ 有効 な cy の の 値 で す 。 


トラ ッ ク を フォ ー マ ッ ト し , バッ ド セ ク タフ ラグ を セッ ト し ます 。 
指定 の トラ ッ ク か ら ド ライ プ を フォ ー マ ッ ト し ます 。 

現在 の ドラ イプ パラ メー タ を 返し ます 。 ド ライ ブ 情 報 は , px7e 中 
の 最初 の 4 バイ ト に 返さ れ ま す 。 

ドラ イプ ベア 性 質 を 初期 化し ます 。 

ロン グリ ー ド (1 セク タ 512 バ イト 十 4 エ キス トラ バイ ト ) を 行ない 
ます 。 

ロン グラ イト (1 セク タ 512 バ イト 十 4 エ キス トラ バイ ト ) を 行ない 
ます 。 

ディ スク シー ク を 行ない ます 。 

ディ スク リセ ッ ト を 行ない ます 。 

セク タバ ッ フ ァ を 読み ます 。 

セク タバ ベッ ファ を 書き ます 。 

指定 の ドラ イプ が レデ ィ か どう か を 調べ ます 。 

ドラ イブ を 再 検 査 し ます 。 

コン トロ ー ラ RAM を 診断 し ます 。 

ドラ イプ を 診断 し ます 。 

コン トロ ー ラ 内 部 を 診断 し ます 。 
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注意 : biosdisk は ,、 ファ イル より 下 の レ ベル で , セク タ を じかに 操作 する 
た め , は 一 ど ディ スク 上 の ファ イル の 内 容 や ディ レク トリ を 壊し て し まう 
可能 性 が あり ます 。 


戻り 値 biosdisk は 以下 の ビッ ト か ら な る ステ ー タ スバ イト を 返し ます 。 
Ox00 操作 に 成功 。 
0x01 不正 な コマ ンド 。 
0x02 アド レス マー ク が 見 つか ら な い 。 
Ox03 書き 込み 禁止 ディ スク に 書き 込 も うと し た 。 
0x04 セク タ が 見 つか ら な い 。 
Ox05 リセ ッ ト に 失敗 (ハー ド デ ィ スク )。 
Ox06 前 回 操作 以降 に ディ スク が 交換 され た 。 
Ox07 ドラ イプ パラ メー タ の 有効 化 に 失敗 。 
0x08 DMA の オー バー ラン 。 
0x09 64K 境界 に また が る DMA を 行 な お うと し た 。 
0x0A 不良 セク タ が 検出 され た 。 
0x0B 不良 トラ ッ ク が 検出 され た 。 
0x0C サポ ー ト され な い ト ラッ ク 。 
Ox10 ディ スク 読み 込み 中 に 不正 な CRC/ECC。 
0x11 CRC/ECC が デー タ エ ラ ー を 修正 し た 。 
0x20 コン トロ ー ラ が 動作 に 失敗 し た 。 
Ox40 シー ク 操 作 に 失敗 し た 。 
Ox80 アタ ッ チ メン ト が 応答 に 失敗 し た 。 
0xAA ドラ イプ ノッ トレ ディ (ハー ド デ ィ スク の み )。 
OxBB 未定 義 の エラ ー が 発生 (ハー ド デ ィ スク の み )。 
OxCC ライ ト フ ォ ル ト が 発生 。 
OxE0 ステ ー タ スエ ラー。 
OxFF セン ス 操 作 に 失敗 。 


0x11 は , その デー タ は 正しい の で エラ ー で は な いこ と に 注意 し て くだ さき 
い 。 い ずれ に せよ その 値 は 返さ れる の で , アプ リケーション 側 で それ が 正 
し いか どう か を 決め る こと が で きま す 。 


可 搬性 biosdisk は , IBM PC と その 互換 機 で の み 動作 し ます 。 
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6ZZ 


関連 項目 absread, asbwrite 
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biosequip 


機能 マシ ン の 装備 を チェッ ク し ます 。 


形式 int biosequip(void) : 


プロ ト タ イ プ biosh 


解説 biosequip は , 現在 シス テム に 接続 きれ て いる 機器 情報 を 返し ます 。 


注意 : この 関数 は BIOS イン ター フェ ー ス で は あり ませ ん 。 


戻り 値 16 ビ ッ ト 中 に 下記 の よう に 情報 が 返さ れ ま す 。 


ビッ ト 14-15 組み 込ま れ て いる パラ レル プリ ンタ の 数 


ビッ ト 13 
ピッ ト 12 
ビッ ト 9-11 
ビ ピット 10 


ビッ ト 6-7 


ビッ ト 5 
ビッ ト 4 


シリ アル プリ ンタ の 接続 
ゲー ム 1/0 の 接続 
送信 ポー ト の 数 
DMA の 有無 
0 = マシ ン は DMA を 持っ て いる 。 
1 = マシ ン は DMA を 持っ て いな い (PC Jr な ど )。 
ディ スク の 数 


00 = 1 ドラ イブ 

01 = 2 ドラ イブ 

10 = ニ 3 ドラ イブ 

11 = 4 ドラ イブ (ビッ ト 0 が 1 の と きのみ ) 
イニ シャ ル 
ば デオ モード 

00 = 未 使用 


01 = 40X25BW. カラ ー カ ー ド つき 
10 80X25BW、 カラ ー カ ー ド つき 
11 80X25BW、 モノ カー ド つ き 
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ビッ ト 2-3 


ビッ ト 1 
ビッ ト 0 


マザー 
00 
01 
10 
11 


ボー ド の RAM サイ ズ 
三 16K 


= 32K 
ニ 48K 
ニ 64K 
浮動 小数 点 コ プロ セッ サ 
ク か ら の プ ブート 


プ グ ィ スス 


biosequip は 、 IBM PC と その 互換 機 で の み 動作 し ます 。 
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bioskey 

機能 キー ポー ドイ ンタ ー フ ェ ー ス で す 。 

形式 int bioskey(int cz の) : 

プロ ト タ イ プ 

解説 bioskey は , BIOS 割り 込み 0x16 を 使っ て . さま ざま な キー ポー ド 操 作 を 行 
な いま す 。 パラ メー タ ci の に よっ て 行なわ れる 操作 が 決ま り ま す 。 

戻り 値 bioskey が 返す 値 は 、 cz に よっ て 決定 され る 操作 に 依存 し ます 。 


bioskey で 行なわ れる 操作 


下位 8 ビッ ト が ゼロ で な い 場 合 、 bioskey は , キュ ー 中 に 待機 し て 
いる 次 の キー スト ロー ク の ASCII 文字 、 あ る い は キー ボー ド 上 
で 次 に 押さ れ た キー を 返し ます 。 下位 8 ビッ ト が ゼロ の 場合 は , 
上 位 8 ビ ッ ト は , IBM PC の テク ニカ ルリ ファ レン スマ ニュ アル 
で 定義 きれ て いる 拡張 キー ポー ドコ ー ド に な り ま す 。 


キー スト ロー ク が 読み 出し 可能 か どう か を テス ト し ます 。 ゼ ロ の 
戻り 値 は 、 キー が 読み 出し 可能 で な いこ と を 意味 し ます 。 そ う で 
な い 場合 は 、 次 の キー スト ロー ク の 値 が 返さ れ ま す 。 キー スト ロ 
ー ク その も の は , ez の の 値 が 0 の 次 の bioskey の 呼び 出し に よっ 
て 返す た め に 保持 され ます 。 


現在 の シフ トキ ー の ステ ー タ ス を 要求 し ます 。 戻り 値 は , 以下 の 
値 の OR を と る こと に よっ て 作ら れ ま す 。 


ビッ ト 7 Ox80  /nser オ ン 
ビッ ト 6 0x40 Caps オン 
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ビッ : ド 5 0x20 ur Lock オン 
ビッ ト 4 0x10 Scro/ Lock オン 
ビッ ト 3 Ox08 AZ が 押さ きれ て いる 
ピット 2 Ox04 Cg7 が 押さ れ て いる 
ビッ トド 1 Ox02 左 S 奉 が 押さ れ て いる 
ビッ ト 0 0x01 右 Sn 奉 が 押さ れ て いる 
可 搬 性 bioskey は , IBM PC と その 互換 機 で の み 動作 し ます 。 
例 #1nclude <stdio.h> 


す 1nclude <bios .h> 
す #1nc1ude <ctype・.h> 


す #define RIGHT 0x0001 
#define LEFT 0x0002 
#define CTRL 0x0004 
#define ALT 0x0007 


main() 
6 
1nt key, modifiersi 


/* 機能 1 は キー が 押さ れる まで 0 を 返し ます 。 キ ー を 繰り 返し 
チェ ッ ク す る こと に よっ て 入力 を 待ち ます 。 p/ 
while (bioskey(1) == 0) 』 


/* 機能 0 を 使っ て その キー の 戻り 値 を 得 ます 。 LA 
key = bioskey(0): 
printf("Key Presses was "): 


/* 操 人 通 2 を 使っ て シフ トキ ー が 使わ れ た か どう か を 調べ ます +*/ 

modifiers = bioskey(2):』 

1f (mofifiers) ( 
printE("["): 
1f (modifiers & RIGHT) printE("RIGHT *): 
if (modifiers & LEFT ) printE("LEFT "): 
1f (modifiers & CTRL ) printf("CTRL "): 
1f (modifiers & ALT ) printf("ALT "): 
printf("] "): 

} 

1f (isalnum(key & OxFE) ) 
Printf(""Zc'n" 。 key): 

el1se 
printf(* メ #02x\n* 。 key): 
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biosmemory 


機能 メモ リサ イズ を 返し ます 。 


形式 int biosmemory (void) ・ 


プロ ト タ イ プ biosh 


解説 biosmemory は 、 BIOS 割り 込み 0x12 を 使用 し て , RAM メモ リ の サイ ズ を 
返し ます 。 こ れ に は , ディ スプ レイ アダ プ タ メ モリ や 拡張 メモ リ は 含ま れ 
ませ ん 。 

戻り 値 biosmemory は 、 1K プ ブロック 単 位 で RAM メモ リ の サイ ズ を 返し ます 。 

可 搬性 biosmemory は 、 IBM PC と その 互換 機 で の み 動作 し ます 。 
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biosprint 


機能 プリ ンタ 1/O を 行ない ます 。 


形式 int biosprint(int cz の, int gpyfe。 int por7) : 


プロ ト タ イ プ biosh 


解説 biosprint は BIOS 割り 込み 0x17 を 使っ て 、 por で 指定 され た プリ ンタ に 
対し て さま ざま な 操作 を 行ない ます 。 
por の 値 0 は LPT1 に , 値 1 は LPT2 に 、…… と いう よう に 対応 し て いま す 。 


cmd の 値 は 以下 の いずれ か で す 。 


0 gpye 中 の 文字 を プリ ント し ます 。 
1 プリ ンタ ポー ト を 初期 化し ます 。 
2 プリ ンタ ステ ー タ ス を 読み 出し ます 。 


g の ye の 値 は 、0 か ら 255 の 範囲 内 で な けれ ば な り ま せん 。 


戻り 値 どの 操作 に お ける 戻り 値 も 以下 の ビッ ト 値 の OR を と っ て 作ら れ , 現在 
の プリ ンタ ステ ー タ ス を 示し ます 。 


ビッ ト 0 Ox01 デバ イス タイ ム ア ウ ト 
ビッ ト 3 Ox08 1I/O エ ラー 

ビッ ト 4 Ox10 セレ クト され て いる 
ビッ ト 5 0x20 用 紙切れ 

ビッ ト 6 0x40 認識 

ビッ ト 7 0x80 ビジ ー で は な い 


可 搬 性 biosprint は , IBM PC と その 互換 機 で の み 動作 し ます 。 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


biostime 


機能 BIOS タイ マ の 読み 出し / 設 定 を 行ない ます 。 
形式 1ong biostime(int cz の , long zew/e) : 


プロ ト タ イ プ biosh 


解説 biostime は , BIOS タイ マ の 読み 出し ある い は 設定 を 行ない ます 。 こ れ は , 
深夜 午前 堆 時 か ら 1 秒 約 18.2 チ ッ ク の レー ト で , チ ッ ク を 計測 する タイ マ で 
す 。biostime は , BIOS 割り 込み 0x1A を 使用 し ます 。 
ez の が 0 の 場合 , biostime は タイ マ の 現在 の 値 を 返し ます 。 ci の が 1 の 場合 
に は , タイ マ は zew/ze 中 の long 値 に セッ ト さ れ ま す 。 


戻り 値 biostime が BIOS タイ マ を 読み 込ん だ と き (cz9=0) に は , タイ マ の 現在 
値 が 返さ れ ま す 。 
可 搬性 biostime は 、 IBM PC と その 互換 機 で の み 動 作 し ます 。 
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Turbo C の サウ ンド ライ ブラ リ は , NEC 製 サ ウン ド ポ ボー ド (PC-9801-26K) を 増設 し た 
と き , また は PC-9801UV2 な ど に 標準 実装 され て いる サウ ンド 機能 の た め の イ ンタ ー フ 
ェ ー ス ルー チン で す 。 サ ウン ド ボ ー ド に は YAMAHA 製 の YM-2203 と いう シン セ サ イ 
ザ LSI が 搭載 され て お り , FM 音源 3 声 と SSG 音源 3 声 の 合計 6 声 に よる 6 重 和 音 演奏 が 
楽し め ま す 。 

イン ター フェ ー ス の 詳細 な 仕様 に つい て は ,、 サウ ンド ポー ド の ユー ザー ズ マ ニュ アル , 
秀和 シス テム トレ ー デ ィング 株 式 会 社 の 「FM 音源 スー パー サウ ンド 」, アス キー 出版 局 
の 「PC-9800 シ リー ズ テク ニカ ル デ ー タ ブッ ク 」 な ど を ご 覧 くだ さい 。 
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図 2.1 は , 利用 者 が 作成 し た MML フォ ー マ ッ ト デ ー タ (楽譜 に 相当 する ) と サウ ンド 
BIOS の 関係 を 表わし た も の で す 。 


図 2.1 MML デ ー タ と サウ ンド BIOS の 関係 


シン セ サ イ ザ LSI ① ユーザ 側 の 領域 
レラ ネタ 
@ 
fe) 
BIOS 管理 
共通 制御 博幸 域 ④⑥ ユー ザ 側 の 領 城 
問い 合わ せ 情報 


@ 


サウ ンド ライ ブラ リク の 領域 
ディ レイ ド デ ー タ 群 


⑤ 


ユー ザ 側 の 領域 
MML デー タ 群 


mc _register の 機能 コー ド 1 に よっ て , 直接 デー タ を LSI の レジ スタ に 設定 し ます 。 

mc register の 機能 コー ド 2 に よっ て , LSI の レジ スタ か ら 直 接 デー タ を 読み 込み ま 

す 。 

③ サウ ンド BIOS の 割り 込み 制御 に よっ て , 逐次 . ディ レイ ド デ ー タ (指令 ) を 読み 
出し て 解析 し , LSI に 命令 を 送っ て 演奏 を 行ない ます 。 また , これ に 伴い 共通 制御 情 
報 城 上 の 管理 情報 を 逐次 更新 し て いま す 。 こ れ ら の 動作 は 利用 者 が 本 来 関知 する 必 
要 は あり ませ ん 。 

④ me _inquire に よっ て , 共通 制御 情報 域 上 の 各 チ ャ ン ネ ル の 制御 情報 を 利用 者 側 の 領 
域 に 読み 出し ます 。 

⑤ memplay に より MML フォー マッ ト デ ー タ を ディ レイ ド フ ォ ー マ ッ ト デ ー タ に 変 

換 し ,、 サウ ンド BIOS に 演奏 を 委託 し ます 。 こ の と き , サウ ンド BIOS の 割り 込み 

処理 が ディ レイ ド デ ー タ (指令 ) を 解析 し , 図 2.2 の ③ や の ④ の デー タ 転 送 操 作 を 行 な 

いま す 。 


@ ら 
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2.2 は 音色 デー タ の デー クタ 転送 を 行なう 関数 や 機能 の 関係 を 表し た も の で す 。 
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2.2 音色 デー タ と デー タ 転 送 関係 


シン セ サ イ ザ LSI ①③ 部 分 的 な 音色 デー タ 
YM-2203 


サウ ンド ライ プラ リ 内 


音色 アー タバ ンク ⑨ 利用 者 作成 の 音色 データ 
7 プロ ッ ク 
| の 
サウ ンド BIOS-ROM 内 


音色 デー タバ ンク 


mc _scalar の 機能 コー ド 1 に よっ て , LSI の レジ スタ の 一 部 を 利用 者 が 指定 し た 値 で 
一 時 的 に 書き 換え ます 。 

mc scalar の 機能 コー ド 2 に よっ て , LSI の レジ スタ の 内 容 を 利用 者 側 の 領域 に 読み 
出し ます 。 

MML 上 に 記述 され た コマ ンド Y に よっ て , LSI の レジ スタ の 一 部 を 一 時 的 に 書き 
換え ます 。 こ れ は ① と 同じ 機能 で す 。 

MML 上 に 記述 され た コマ ンド @x に よっ て , ブロ ッ ク 単 位 で 音色 デー タ を LSI の 
レジ スタ に 設定 し ます 。 

me_block の 機能 コー ド 1 に よっ て , 利用 者 が 作成 し た 音色 デー タ を サウ ンド ライ ブ 
ラリ 内 の バン ク に 登録 し ます 。 

mc block の 機能 コー ド 2 に よっ て , サウ ンド ライ ブラ リ 内 の 音色 デー タバ ンク を 利 
用 者 側 の 領域 に 読み 出し ます 。 

mc rom に より ROM 内 の 音色 デー タ を サウ ンド ライ ブラ リ 内 の 音色 デー タバ ベン 
ク に 再 設定 し な お し ます 。mc initialize も 使用 し て いま す 。 
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MML を BNF (バッ カス ・ ナ ウ ア 記法 ) で 表現 し た も の を 以下 に 示し ます 。 


< 人 L> = [ < コマ ンド 辞 > ... 
< コマ ンド 群 > = 
< 音 待 コ マン ド > | < エン ベロ ー プ 周期 コマ ンド > ! 
< エン ベロ ー プ ブ 形状 コマ ンド > | < 音量 コマ ンド > | 
< 省略 時 の 音 長 コマ ンド > | < 音 長 比率 コマ ンド > | 
< オク ター プ コ マン ド > | < オク ター プ 上 下 コ マン ド > | 
< 音程 直接 コマ ンド > | < テン ポコ マン ド > | < 休 待 コマ ンド > 1 
< 音色 コマ ンド > | < レジ スタ コマ ンド > | < 休止 コマ ンド > | 
< 移調 コマ ンド > | <LEO 効 果 コ マン ド > | 
< 音色 パラ メー タコ マン ド > | < 演奏 形態 コマ ンド > 
< 音 待 コ マン ド > = < 音 種 > [ < 半音 隊 > ] [ < 音 長 > ] 
< エン ベロ ー プ 周期 コマ ンド > ::= *M" < 数 値 > 
< エン ベロ ー プ ブ 形状 コマ ンド > *S* < 数 値 > 
< 音量 コマ ンド > *V' < 数 値 > 
< 省略 時 の 音 長 コマ ンド > *L" < 音 長 > 
< 音 長 比率 コマ ンド > *Q" < 数 値 > 
< オク ター プ コ マン ド > *0* < 数 値 > 
< オク ター プ 上 下 コマ ンド > て 導 アロ 
< 音程 直接 コマ ンド > *K" < 数 値 > 
< テン ポコ マン ド > *T* < 数 値 > 


] ・*0・ 


< 休 待 コマ ンド > ( "R' | *P' ) [ < 音 長 > ] 
< 音色 コマ ンド > "6" < 数 値 > 

< レジ スタ コマ ンド > *Y" < 数 値 > "," < 数 値 > 

< 休止 コマ ンド > "[ < 音 長 > ] 

< 移調 コマ ンド > < 音 種 > 


<LFO 効 果 コ マン ド > 

< 音色 パラ メー タコ マン ド > 
< 連 待 コマ ンド > 

< 帝 奏 形 態 コ マン ド > 

< 音 種 > 

< 半音 階 > 

< 音 長 > 

< 数 値 > 

< 数 字 > 


CE 


*2* < 数 値 > "," < 数 値 > 


"(" < コマ ンド 辞 > ... ")" [< 音 長 >] 
mr (81 
GETPT 1 YE 1 YE 1 T6GT 1 YAO 1 TB* 


DEP 
< 数 値 > [ *." ][ "へ "< 数 値 > ] 
< 数 字 > 

lr iT27 1 TS7 FT4T 1 
YO 777 1 "87 1 Yor 


罰 文 字 と 文字 の 間 の 空白 や タブ は 意味 を 持ち ませ ん 。 また, 文字 は 半角 文字 の み で 全角 


文字 は 許さ れ ま せん 。 


罰 表 記 の 中 で 使わ れ て いる 記号 は 、 次 の よう な 意味 を 持っ て いま す 。 


a を 選択 し ます 。 省 略し て も か まい ませ ん 。 
a を 必 ら ず 選 択 し ます 。 

a か b どちら か を 必 ら ず 選 択 し ます 。 

ai a を 繰り 返し ます 。 


[a] 
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注意 : サウ ンド ライ ブラ リ の 一 部 の 関数 で は , デー タ の や り と り に パケ ッ ト 構 造 体 を 使用 
し て いま す 。 パ ケッ ト 構 造 体 に つい て は この 章 の 「PC-9801 の ROWM-BIOS イン ター フェ 
ー ス 」 の 節 の 最初 に 説明 が ある の で , 表 の 見 方 な ど は そちら を 参照 し て くだ さい 。 
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mc_block 


機能 


プロ ト タ イ プ 


解説 


音色 デー タ を 設定 また は 読み 出し ます 。 


#include <music.h> 
int mc_block(MC_BLOCK * が) : 


music.h 


mc block は 、 音色 デー タ (パラ メー タプ ロッ ク ) の 設定 , 読み 出し を 行 な 
いま す 。 

パケ ッ ト 内 の 機能 コー ド cmmd が 1 の と き , 音色 デー タ 番 号 base で 指定 さ 
れ た サウ ンド ライ プラ リ 内 の 音色 デー タバ ンク に パケ ッ ト 内 の 個々 の 項目 
を 設定 し ます 。 

機能 コー ド が 2 の と き , 音色 デー タ 番 号 base で 指定 され た サウ ンド ライ ブ 
ラリ 内 の 音色 デー タバ ンク か ら パ ケッ ト 内 の 個々 の 項目 に 読み 込み ます 。 
構造 体 MC INQUIRE は , music.h で 次 の よう に 定義 され て いま す 。 


typedef struct 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 


/* 機能 コー ド */ 

/* 実行 後 の 状 態 */ 

/* 音色 デー タ 番 号 0 一 81 メ / 

/* フィ ー ド バッ ク / ア ル ゴ リ ズム */ 
/* アタ ッ ク 係 数 */ 

unsigned char /* オペ レー タマ スク +*/ 

unsigned char /* ディ ケイ 係数 */ 

unsigned char wav_form 1fo: /* LEO 波 長 */ 


unsigned char ss_r[4]i /* サス ティ ン 係 数 */ 
unsigned char sync_d1y 1fo: /* LEOSYNC 層 延 時 間 */ 
unsigned char r1 r[4]i /* リリ ー ス 係数 */ 

unsigned int speed 1foi /* LO 効果 の 速度 */ 
unsigned char ss_1[4]: /* サス ティ ン レ ベル +*/ 
unsigned char p_mod_1fo: /* LFO 効 果 の ビッ チ 変 調 深 さ */ 
unsigned char op_1[4]: /* 出 カ レベ ル */ 

unsigned char a_ mod 1foi /* LFO 効 果 の 振幅 変調 深 さ */ 
unsigned char keysc1[4]: /* KEY スケ ー リ ング 深 さ */ 
unsigned char p_mos 1foi /* LFO 効 果 ビ ピッ チ 変 調 深 さ ( 粗 調整 ) */ 
unsigned char mult[4]: /* マル チ ブ プル */ 

unsigned char resv1: な 予約 */ 

unsigned char detun[4]: /* デ チ ュー ン 係 数 */ 
unsigned char resy2: /* 予約 */ 


uneigned char a_mos_1fo[4]: /* LFO 効 果 振幅 変調 深 さ ( 粗 調整 ) */ 
) MC_BLOCK: 
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戻り 値 
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音色 デー タ の 詳細 は サウ ンド ボー ド ユ ー ザ ー ズ マニ ュ ア ル と 「FM 音源 ス 


ー パ バー サウ ンド 」 を 参照 し て くだ さい 。 


音色 デー タ 番 号 base が 異常 な と き , 0 以外 を 返し ます 。 ま た , パケ ッ ト 内 
の 終了 状態 stus が 設定 され ます 。 


田 パ ケッ ト 内 の デー タ の 授受 


MC BLOCK 01 02 
cmmd R R 
stus WW 
base R R 
fb alg RW 
atr R W 
opr_msk R W 
dc r[4] RW 
wav_form_lfo R W 
SS T R W 
sync_ dly lfo RW 
rlr RW 
speed lfo R W 
ss 1 R W 
p_mod lfo R W 
op 1 R W 
a_mod lfo R W 
keyscl R W 
p_mos lfo RW 
mult R W 
resv1 R W 
detun R W 
resV2 R W 
a_mos lfo R W 
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可 搬性 この 関数 は PC-9801 シ リー ズ で の みろ 動作 し ます 。 


関連 項目 mc_scalar、me rom 
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mc_continue 


機能 演奏 を 再開 し ます 。 
形式 void mc continue(void) : 


プロ ト タ イ プ music.h 


解説 me continue は , mc stop で 中 断 さ れ て いた 箇所 か ら 演 奏 を 再開 し ます 。 
た だ し , me_initialize を 実行 し た と き は 再開 され ませ ん 。 


戻り 値 あり ませ ん 。 
可 搬 性 この 関数 は PC-9801 シ リー ズ で の みろ 動作 し ます 。 


関連 項目 mc stop 
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mc_ground 


機能 演奏 モー ド を 切り 換え ます 。 

形式 int mc_ground(int rode) : 

プロ ト タ イ プ music.h 

解説 me_ground は , 指定 され た zode に より 演奏 モー ド を フォ アグ ラウ ンド ま 
た は バッ ク グ ラウ ンド モー ド に 切り 換え ます 。 引 数 ode が 1 の と き は フォ 
アグ ラウ ンド モー ド を 意味 し 、 2 の と き は バッ ク グ ラウ ンド を 意味 し ます 。 
フォ アグ ラウ ンド の と き は 演奏 が 終了 する ま て 次 の 処理 は を 行ない ませ ん 。 
現在 の モー ド を 知り た いと き は me inquire を 使用 し て くだ さい 。 

戻り 値 de が 範囲 外 の と き は 0 以外 を 返し ます 。 


可 搬性 この 関数 は PC-9801 シ リー ズ で の み 動作 し ます 。 


関連 項目 mc inquire 
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mc_initialize 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


696 


サウ ンド ライ プラ リグ の 実行 環境 を 初期 化し ます 。 

int mc initialize(void) : 

music.h 

me _initializee は 、 サ ウン ドラ イプ ラリ グ の 実行 環境 を 初期 化し ます 。 他 の サ 
ウン ド 関 数 を 実行 する 前 に , 必 ら ず こ の 関数 を 一 度 実行 し な けれ ば な り ま 
せん 。 ま た , この 関数 は サウ ンド 拡張 機能 を 次 の よう に 初期 化し ます 。 各 


チャ ン ネ ル の ディ レイ ド デ ー タ 用 領域 は 300 バ イト に 固定 され て いま す 。 


田 SSG エンベロープ  : M255, S1 


田 SSG 音量 > V7 

国 音 長 : 上 4 (R4) 

玉音 の 長 さ の 割合 : Q7 

圏 オ クタ ー ブ ・ 04 

較 テ ン ポ : T120 

田 FM チャ ン ネ ル 音 色 : 0 (デフ ォ ル ト 音 量 ) 
国 音 色 バ ンク : 立 上 げ 時 の 状態 に 設定 

一 演 克 モー ド : フォ アグ ラン ド , 楽 音 モー ド 


この 関数 は N88-BASIC(86) の サウ ンド 拡張 命令 PLAY ALLOC に 相当 
し ます 。 


サウ ンド ポー ド が 実装 され て いな いと き に は , 0 以外 を 返し ます 。 


この 関数 は PC-9801 シ リー ズ で の み 動 作 し ます 。 
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mc_imquire 


機能 


形式 


プロ ト タ イ プ 


解説 


演奏 状況 を 調べ ます 。 


#include <music.h> 
int mc inquire(MC INQUIRE * 2) : 


music.h 


me _inquire は , 構造 体 MC INQUIRE 内 に 全 チ ャ ン ネ ル の エン プティ 割 
り 込 み 条 件 、 未 演奏 デー タ 長 、 カ レン ト Key-No.,。 デフ ォ ル ト 音 長 、 カレ 
ント タッ チ 。, 演奏 中 フラ グ と テン ポ 数 を 返し ます 。 ま た , メン バ 
maxsize, minsize に 全 ナ チャ ン ネ ル 中 で 最長 の 未 演奏 デー タ 長 と 最短 の 未 
演奏 デー タ 長 を 返し 、 メン バ allbusy に は 全 チ ャ ン ネ ル 中 で 現在 演奏 中 か 
どう か を 返し ます 。1 つ で も 演奏 中 の と き は 0 以外 を , 全 演 奏 が 終了 し て い 
る と き は 0 を 返し ます 。 メン バ ground は 現在 フォ アグ ラウ ンド (1) か バッ 
ク グ ラウ ンド (2) で ある か を 示し , メン バ mode は 現在 の 演奏 モー ド を 示し 
て いま す 。 
構造 体 MC INQUIRE は , music.h で 次 の よう に 定義 る 8 れ て いま す 。 
typedef struct 人 
unsigned char 


unsigned char 
nt 


/* 機能 コー ド 現在 未 使用 */ 

/* 実行 後 の 状 態 現在 未 使用 */ 

/* 各 チ ャ ン ネ ル の 未 演奏 デー タ 長 */ 
unsigned int /* 各 チ ャ ン ネ ル の 割り 込み 条件 */ 
unsigned char /* 各 チ ャ ン ネ ル の カレ ント キー 番号 */ 
unsigned char 1ength[6]: /* 各 チ ャ ン ネ ル の デフ ォ ル ト 音 長 */ 


unsigned char touch[6]:  /* 各 チ ャ ン ネ ル の カレ ント タッ チ *#/ 
unsigned char busy[6]:  /* 各 チ ャ ン ネ ル の 演奏 中 フラ グ */ 
unsigned char tempoi /* テン ポ 数 */ 

int maxs1ze: /* 最長 の 未 演奏 デー タ 長 */ 

int mins1ze: /* 最短 の 未 演奏 デー タ 長 */ 

char groundi /* 現在 の 処理 モー ド 1, 2 */ 

char mode: /* 現在 の 演奏 モー ド 1, 2, 3 ォ / 


unsigned char a11busy:  /* 全 チ ャ ン ネ ル の 演奏 状況 */ 
) MC_INQUTRE: 
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戻り 値 全 ナ ャ ン ネ ル の 演奏 状況 allbusy と 同じ 値 を , 16 ビ ッ ト 中 の 下位 8 ビッ ト に 
返し ます 。 


圏 パ ケッ ト 内 の デー タ の 授受 


MC INQUIRE 


cmmd 
Stus 
unsize 
empty 
keyno 
length 
touch 
busy 
tempo 
maxsize 
minsize 
ground 
mode 


るる ミミ る ミタ ミズ ミコ ラダ タコ x メ 


allbusy 


可 搬性 この 関数 は PC-9801 シ リー ズ で の み 動 作 し ます 。 


関連 項目 mc_play, mc ground, mc mode 
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mc_mode 


機能 チャ ン ネ ル 3 に 対し て モー ド を 指定 し ます 。 

形式 int mc mode(int 7 が ) : 

プロ ト タ イ プ music.h 

解説 mc mode は 、 チャ ン ネ ル 3 (サウ ンド ライ ブラ リ 内 で は CH2) の FM 音源 
に 対す る モー ド 指 定 で す 。 引 数 777 が 1 の と き は 楽 音 モー ド , 2 の と き は 効果 
音 モ ー ド , 3 の と き は CSM モー ド を 意味 し ます 。 現在 の モー ド を 知り た い 
と き は mc _inquire を 使用 し て くだ さい 。 

戻り 値 7 が 範囲 外 の と き は 0 以外 を 返し ます 。 


可 搬性 この 関数 は PC-9801 シ リー ズ で の みろ 動作 し ます 。 


関連 項目 mc inquire 
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mce_play 


機能 演奏 を 行ない ます 。 


形式 #include <music.h> 
int mc play(MC MML * zz/) : 


プロ ト タ イ プ music.h 


解説 me_ play は , 構造 体 MC MML 内 の メン バ 7 に 与え られ た MML の 指 
示 に し た が っ て 音楽 を 演奏 し ます 。MML の フォ ー マ ッ ト の 詳細 は サウ ン 
ド ポ ボー ド ユ ー ザ ー ズ マニ ュ ア ル を 参照 し て くだ さい 。MML を 指定 し な い 
チャ ン ネ ル は , NULL ポイ ンタ を 設定 する か , また は NULL 文字 列 を 与え 
ます 。 構 造 体 MC MML は ヘッ ダフ ァイル music.h に 下記 の よう に 定義 さ 


れ て いま す 。 

typedef struct { 
unsigned char cmmdi /* 機能 コー ド 現在 未 使 用 */ 
unsigned char stuei /* 実行 後 の 状態 現在 未 使用 */ 
char *mm1 6] /* AL 文字 列 配列 */ 
nt err_chi /* エラ ー チ ャ ン ネ ル 番 号 */ 
nt err_pOSi /* エラ ー 位 置 */ 

) MC_IAL: 


注意 : チャ ン ネ ル 番 号 は 通常 CH1--CH6 で 表現 きれ ます が サウ ンド ライ 
プラ リ 中 で は CH0 一 CH5 で 表現 し ます 。 


この 関数 は N88-BASIC(86) の サウ ンド 拡張 命令 PLAY に 相当 し ます 。 
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戻り 値 正常 終了 し た と き は 0 を 返し , 指定 され た MML に て エラ ー が 発生 し た と 
き は 0 以外 を 返し ます 。 ま た , パケ ッ ト 内 の 変数 err ch に エラ ー を 起こ し た 


チャ ン ネ ル 番 号 , 変数 err pos に エラ ー を 起こ し た MML 文字 列 中 の 位置 
を 返し ます 。 


還 パ ケッ ト 内 の デー タ の 授受 


可 搬性 この 関数 は PC-9801 シ リー ズ で の みろ 動作 し ます 。 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 一 


mc_register 


機能 サウ ンド LSI 内 の レジ スタ を 操作 し ます 。 


形式 #include <music.h> 
void mc register(MC_REGISTER * 7eg) : 


プロ ト タ イ プ musich 


解説 me _register は 、 サ ウン ド LSI の 各 レ ジス タ に デー タ を 直接 設定 し た り , 
読み 出し を 行なっ た り し ます 。 
バケット 内 の 機能 コー ド cz が 1 の と き , レジ スタ 番号 7eg で 指定 され 
た レジ スタ に 設定 値 wwe を 設定 し ます 。 
機能 コー ド cz の が 2 の と き , レジ スタ 番号 zeg で 指定 され た レジ スタ を 
読み 込み 値 yg/e に 読み 込み ます 。 
構造 体 MC_REGISTER は , music.h で 次 の よう に 定義 され て いま す 。 


typedef struct て 


unsigned char cmmdi /* 機能 コー ド */ 

unsigned char stusi /* 実行 後 の 状 態 */ 

unsigned char regi /* レジ スタ 番号 Ox00 こ OxFF */ 
unsigned char valuei /* 設定 値 プ 読込 値 */ 


) MC_REGTSTER: 


SSG 周波 数 、SSG ノイ ズ , 固定 量 / 可 変 音量 、 エンベロープ 周期 , エ ン ベ 
ロー ブ 形 状 等 の 機能 の 操作 は , この 関数 に よっ て 行ない ます 。 

この 関数 は N88-BASIC(86) の サウ ンド 拡張 命令 VOICE REG に 相当 し 
ます 。 
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戻り 値 あり ませ ん 。 


一 バケット 内 の デー タ の 授受 


MC REGISTER |01 02 
cmmd R R 
ZS 全く 
7eg R R 
yo/ze R W 
可 搬性 この 関数 は PC-9801 シ リー ズ で の みろ 動作 し ます 。 


PC-9801 サ ウン ドラ イブ ラリ 703 


mc_rOonm 


機能 音色 デー タバ ンク を 再 設定 し ます 。 

形式 int mc rom(int pgse, int ヵ ) : 

プロ ト タ イ プ musich 

解脱 me _rom は 、 引数 gzse で 指 さ れ る サウ ンド BIOS-ROM 内 の 音色 デー タバ 
ンク か ら 引 数 ヵ 個 分 を , 該当 する サウ ンド ライ ブラ リ 内 の 音色 デー タバ ン 


ク に 再 設定 し ます 。 


戻り 値 サウ ンド BIOS-ROM が 存在 し な いと き は 0 以外 を 返し ます 。2gse と ヵ の 
関係 が 不正 な と き は 0 以外 を 返し ます 。 


可 搬性 この 関数 は PC-9801 シ リー ズ で の み 動 作 し ます 。 


関連 項目 mc block 
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mc_scalar 


機能 チャ ン ネ ル の 各 パ ラメ ー タ の デー タ の 設定 / 読 み 出 し を 行ない ます 。 


形式 #include <music.h> 
int mc scalar(MC SCALAR * scg) : 


プロ ト タ イ プ musich 


解説 me_scalar は , サウ ンド LSI の 各 チ ャ ン ネ ル の 各 パ ラメ ー タ に デー タ を 単 
体 で 設定 し た り , 読み 出し を 行なっ た り し ます 。 
パケ ッ ト 内 の 機能 コー ド cmmd が 1 の と き , チャ ン ネ ル 番 号 ch と パラ メー 
タ 番 号 param で 指定 され た 機能 バ パラメータ に 設定 値 value を 設定 し ます 。 
機能 コー ド cmmd が 2 の と き ,、 チャ ン ネ ル 番 号 ch と パラ メー タ 番 号 
param で 指定 され た 機能 パラ メー タ を 読み 込み 値 valuc に 読み 込み ます 。 
構造 体 MC_SCALAR は , music.h で 次 の よう に 定義 され て いま す 。 


typedef struct { 


unsigned char cmmdi /* 機能 コー ド */ 
unstgned char stusi /* 実行 後 の 状態 */ 
unsigned char chi /* チャ ン ネ ル 番 号 CHO こ CH5 */ 


uns1gned char parami /* パラ メー タ 番 号 0 ご 49 */ 
unsigned nt valuei /* 設定 値 プ 読込 値 */ 
) MC_SCALAR: 


戻り 値 チャ ン ネ ル 番 号 ch と パラ メー タ 番 号 param が 異常 な と き , 0 以外 を 返し 
ます 。 また, パケ ッ ト 内 の 終了 状態 stus が 設定 され ます 。 
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較 パ ケッ ト 内 の デー タ の 授受 


MC SCALAER 01 02 
cmmd R R 
stus W W 
ch R R 
param R R 
Value R W 
可 搬性 この 関数 は PC-9801 シ リー ズ で の みろ 動作 し ます 。 


関連 項目 me block 
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mc_stop 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


演奏 を 中 断 し ます 。 


void mc _stop(void) : 


music.h 


me _stop は , 全 チ ャ ン ネ ル の 演奏 を 中 断 し ます 。 演奏 中 に ユー ザ プ ブロ グラ 
ム が 終了 する と き は , 通常 この 関数 を 呼び 出し ます が , 実行 し な く て も 演 
奏 は 自動 的 に 中 止 さ れ ま す 。 これ は 演奏 中 に C7RL-C を 押し た 場合 で も 有 
効 で す 。 逆 に 演奏 し た まま で 利用 者 の プロ グラ ム を 常駐 終了 させ た いと き 
は , 次 に 示す 変数 を プロ グラ ム で 外部 定義 し て くだ さい 。 


1nt mc_nonetop = 1 


通常 . ユ ー ザ プロ グラ ム で 最後 まで 演奏 する と き に は , me_inquire に よっ 
て 演奏 が 全 チ ャ ン ネ ル が 終了 し た か チェ ッ ク し て か ら me stop を 実行 し 
ます 。 


注意 プロ グラ ム を 強制 終了 させ る に は , C7RL-C を 押す 方 法 と S7OP キ 
ー を 押す 方 法 が あり ます 。 シ ステ ム が ハー ド デ ィ スク を 備え て いる 場合 に 
S7OP キー で 強制 終了 させ る と , シス テム が 暴走 する こと が ある の て 注意 
し て くだ きい 。 

あり ませ ん 。 


この 関数 は PC-9801 シ リー ズ で の み 動 作 し ます 。 


mc continue 
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日 本 語 処理 ライ ブラ リ 


TurboC は , 日 本 語 を 正しく 処理 する こと が で きる よう に な っ て いま す 。 もう少し 具体 
的 に 言え ば , 文字 列 内 に 含ま れる 全角 文字 (2 バイ トコ ー ド ) を , 全角 文字 と し て 正しく 認 
識 し , 処理 する と いう こと で す 。 ま た , 全角 文字 と ANK 文字 の 判別 や , 全角 文字 と し て 
正しい コー ド か どう か の 判定 , 全角 文字 か ら 半 角 文 字 へ (ある い は その 逆 ) の 変換 な ど を 
行なう ライ プラ リル ー チ ン も 用 意 さ れ て いま す 。 

この 章 で は 、 プ ログ ラム て で 漢字 を 使用 する 際 の 注意 点 (ほん の 少し で す が ) を 最初 に 述 
べ , その あと 日 本 語 処理 ライ プラ リ 関 数 の リフ ァ レ ンス を の せ て あり ます 。 
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漢字 オプ ショ ン 


全角 文字 の 第 1 バイ ト は , 0x81 一 Ox9F, お よび OxE0 一 0xFC の 範囲 に な り ます 。 こ の 範 
囲 の ロード は , モー ド に よっ て は グラ フォ ッ ク 文 字 と し て 使用 きれ ます 。 

全角 文字 の 第 2 バイ ト の 範囲 は Ox40 一 Ox7E, お よび Ox80 一 0xFC で す 。 この 男 囲 の コー 
ド は , ANK の 英字 と 記号 の 一 部 , 半角 の カタ カナ , お よび グラ フィ ッ ク 文 字 と 重なっ て い 
ます 

C で 全角 文字 を 扱う 際 に 問題 に な る の は , この 第 2 バイ ト 目 が " 半 x5C' (円 記号 ) の 場合 で 
す 。 円 記号 は , C の 文字 列 で は 通常 エス ケー プシ ー ケ ンス と し て 使用 きれ て いる の で , その 
まま で は 文字 化け な どの 思わ ぬ 結 果 に な っ て し まい ま す 。 

TurboC に は , 文字 列 内 の 円 記号 の コー ド を エス ケー プシ ー ケ ンス と し て で は な く 。 そ 
の まま 文字 列 の 一 部 と し て 扱い 。 また 全角 文字 は 2 バイ ト 単 位 で 正しく 扱う よう に する た め 
の オプ ショ ン (漢字 オプ ショ ン ) が 用 意 さ きれ て いま す 。 デフ ォ ル ト で は 漢字 オプ ショ ン は 
オン に な っ て お り , 文字 列 の 中 の 0x81 一 0x9F お よ び OxE0 一 0xFC の コー ド は 全角 文字 の 
第 1 バイ ト で ある と 認識 され , その 次 の 1 バイ ト は 全角 文字 の 第 2 バイ ト と みな され ます 。 

漢字 オプ ショ ン を オフ に する と , その 範囲 の コー ド は 1 バイ ト 単 位 で グラ フィ ッ ク 文 字 と 
し て 扱わ れる こと に な り ま す 。 

漢字 オプ ショ ン は 、 TC( 統 合 環境 版 ) で は 。 Options/Compiler メニ ュー の , Code genera- 
tion/Kanji strings で す 。TCC (コマ ンド ライ ン 版 ) で は -J」 に な っ て いま す 。 グラ フィ ッ 
ク 文 字 を 使用 する 場合 に は , メニ ュー オプ ショ ン を オフ に する か , TCC で あれ ば コマ ンド 
ライ ン (また は TURBOC.CFG の 中 ) で -- を 指定 し て くだ さい 。 
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btom 


機能 文字 列 の 先頭 か ら nbyte まで に 存在 する 文字 数 を 調べ ます 。 


形式 unsigned int btom(char * sg, unsigned int z) : 


プロ ト タ イ プ jstring.h 


解説 btom は , 引数 sg で 指定 され た 文字 列 の 先頭 か ら ィ バイ ト ま で に 存在 
する 文字 数 を 調べ ます 。 全 角 文 字 も 1 文字 と し て 数 えま す 。 
指定 し た ヵ バ イト 内 に ヌル 文字 が 現われ た 場合 は 、 そ の ヌル 文字 の 直前 ま 
で の 文字 数 を 返し ます 。 さ きら に この ヌル 文字 が 漢字 2 バイ ト 目 に あたる 場合 
は , その 前 の 漢字 第 1 バイ ト 目 も ヌル 文字 と みな し て 文字 数 に は 含み ませ 
ん 。 ま た ヵ バ イト 目 が 漢字 1 バイ ト で ある 場合 も その 直前 まで の 文字 数 を 


返し ます 。 

戻り 値 btom は , 指定 され た 男 囲 の 文字 数 を 返し ます 。 ヵ に 0 を 指定 する と 0 が 返さ 
れ ま す 。 

可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 mtob 
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ーー ニー ニー テーーー ニ ーー ニニ ニー ニー ニニ ーー ニー ニー ニー ニー 、 ミ 、 


chkctype 


機能 文字 タイ プ を 調べ ます 。 


形式 #include <jctype.h> 
int chktype(char c, int pe) : 


プロ ト タ イ プ jctypeh 


解説 chkctype は , 文字 て の タイ プ を 調べ ます 。 引 数 pe に よっ て , タイ プ を 判 
定 す る 基準 を 指定 し ます 。 
Pe の 値 と 戻り 値 の 関係 は 次 の よう に な り ま す 。 


ーーーーー ニ ーーーーーーー シ ーー トー 


の /e 戻り 値 ( 値 ) 意味 

1 以外 CT_ANK (0) ANK 文 字 

1 以外 CT_KJI (1 漢字 第 1 バイ ト 
1 CTKJ2 (2) 漢字 第 2 バイ ト 
1 CTILGL (-1) 無効 を タイプ 


無効 み タ イプ と は , 漢字 の 第 2 バイ ト が jskanji2 で な いか , c が ヌル 文字 で 
ある 場合 を 意味 し ます 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 nthctype 


日 本 語 如 理 ライ プラ リ 711 


hantozen 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 


712 


半角 文字 を 全角 文字 に 変換 し ます 。 


unsigned short hantozen (unsigned short c) : 


jctypeh 


hantozen は , 半角 文字 c を 全角 に 変換 し ます 。 た だ し 変換 が 行なわ れる の 
は , 半角 文字 が 0x20 一 0x7e の 範囲 に 限ら れ ま す 。 


hantozen は , 変換 が 正しく 行なわ れれ ば , 変換 後 の 文字 コー ド を 返し ま 
す 。 変 換 で き な か っ た 場合 に は , c を その まま 返し ます 。 


MS-DOS に 特有 の 関数 で す 。 


Zentohan 
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isalkana 


機能 英文 字 ま た は カナ 文字 か どう か を 判定 し ます 。 


形式 #include <jctype.h> 
int isalkana(int c) : 


プロ ト タ イ プ jctype.h 


解説 isalkana マク ロ は ,、c が 英文 字 ま た は カナ 文字 で ある か どう か を 判定 し ま 
す 。 (isalpha iskmoji) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 、 そう で な けれ ば 0 を 返し ます 。 
可 搬性 MS-DOS に 特有 の マク ロ で す 。 

isalnmkana 

機能 英 数 字 また は カナ 文字 か どう か を 判定 し ます 。 

形式 #include ctype.h> 


int isalnmkana(int c) : 


プロ ト タ イ プ jctypeh 


解説 isalnmkana マク ロ は , c が 英 数 字 ま た は カナ 文字 で ある か どう か を 判定 
し ます 。 (isalnum iskmoji) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を . そう で な けれ ば 0 を 返し ます 。 


可 搬性 MS_-DOS に 特有 の マク ロ で す 。 


日 本 語 処 理 ラ イブ ラリ 713 


isgrkana 


機能 スペ ー ス 以外 の 半角 文字 か どう か を 判定 し ます 。 


形式 #include ctype.h> 


int isgrkana(int c) : 


プロ ト タ イ プ jctypeh 


解説 isgrkana マク ロ は , c が スペ ー ス 以外 の 半角 文字 かど うか を 判定 し ます 。 
(isgraph 二 iskana) 

戻り 値 条件 を 満た せ ば 0 以外 の 値 を 、 そう で な けれ ば 0 を 返し ます 。 

可 搬性 MS-DOS に 特有 の マク ロ で す 。 

iskana 

機能 半角 の カナ コー ド か どう か を 判定 し ます 。 

形式 #include <jctype.h> 


int iskana(int c) ・ 
プロ ト タ イ プ jctype.h 


解説 iskana マク ロ は , c が 半角 の カナ コー ド か どう か を 判定 し ます 。 
(0xA1 ミ c ミ OxDF) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 。 そ う で な けれ ば 0 を 返し ます 。 


可 搬性 MS-DOS に 特有 の マク ロ で す 。 
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iskan 


< 
ご ・ 


機能 漢字 第 1 バイ ト か どう か を 判定 し ます 。 
形式 #include <jctype.h> 
int iskanji(int c) : 
プロ ト タ イ プ jctypeh 
解説 iskamji マク ロ は 、 c が 漢字 第 1 バイ ト か どう か を 判定 し ます 。 
(Ox81 ミ c ミ Ox9F また は OxEO = cs OxFC) 
戻り 値 条件 を 満た せ ば 0 以外 の 値 を 、 そう で な けれ ば 0 を 返し ます 。 
可 搬性 MS-DOS に 特有 の マク ロ で す 。 
iskanji2 
機能 漢字 第 2 バイ ト か どう か を 判定 し ます 。 
形式 #include <jctype.h> 
int iskanji2(int c) : 
プロ ト タ イ プ jctypeh 
解説 iskanji2 マク ロ は ,c が 漢字 第 2 バイ ト か どう か を 判定 し ます 。 
(0x40 ミ c ミ Ox7E また は Ox80 ミ c ミ OxFC) 
戻り 値 条件 を 満た せ ば 0 以外 の 値 を 。 そう で な けれ ば 0 を 返し ます 。 
可 搬性 MS-DOS に 特有 の マク ロ で す 。 


日 本 語 処理 ライ ブラ リ 
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ー ロ 


iskmo 


機能 半角 の カナ 文字 か どう か を 判定 し ます 。 


形式 #include <ctype.h> 
int iskmoji(int c) : 


プロ ト タ イ プ jctypeh 


解説 iskmoji マク ロ は , c が 半角 カナ 文字 か どう か を 判定 し ます 。 
(OxA6 = c ミ OxDF) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を そう で な けれ ば 0 を 返し ます 。 
可 搬性 MS-DOS に 特有 の マク ロ で す 。 

iskpun 

機能 半角 の カナ 句読点 か どう か 判定 し ます 。 

形式 #include <jctype.h> 


int iskpun(int c) : 
プロ ト タ イ プ jctypeh 


解説 iskpun マク ロ は , c が カナ 句読点 か どう か を 判定 し ます 。 
(0xA1 ミ c ミ OxA5) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を . そう で な げ れ ば 0 を 返し ます 。 


可 搬性 MS-DOS に 特有 の マク ロ で す 。 
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ispnkana 


機能 英 句 読点 また は カナ 句読点 で ある か どう か を 判定 し ます 。 


形式 #include ctype.h> 


int ispnkana(int c) : 


プロ ト タ イ プ jctypeh 


解説 ispnkana マク ロ は ,c が 英 句 読点 また は カナ 句読点 で ある か どう か を 判定 
し ます 。 (ispunct 十 iskpun) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 、 そう で な けれ ば 0 を 返し ます 。 
可 搬性 MS-DOS に 特有 の マク ロ で す 。 

isprkana 

機能 半角 文字 か どう か を 判定 し ます 。 

形式 #include <jctype.h> 


int isprkana(int c) : 


プロ ト タ イ プ jctype.h 


解説 isprkana マク ロ は , c が 半角 文字 か どう か を 判定 し ます 。 
(isprint 十 iskana) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 。 そう で な けれ ば 0 を 返し ます 。 


可 搬 性 MS-DOS に 特有 の マク ロ で す 。 


日 本 語 処理 ライ ブラ リ Z1Z 


jasctime 


機能 asctime の 日 本 語 対応 版 で す 。 


形式 #include <time.h> 


char * jasctime(const struct tm * の): 


プロ ト タ イ プ timeh 


解説 jasctime は 、asctime の 日 本 語 対 応 版 で , 変換 後 の 文 字 列 は 次 の 形式 に な 
り ま す 。 


1988 年 09 月 23 日 ( 金 ) 07:15:06wnwO 


詳細 に つい て は asctime を 参照 し て くだ さい 。 


戻り 値 変換 後 の 文 字 列 へ の ポイ ンタ を 返し ます 。 
可 搬性 MS-DOS に 特有 の 関数 で す 。 
関連 項目 asctime, ctime, jctime 
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jctime 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 


ctime の 日 本 語 対応 版 で す 。 


#include <time.h> 
char * jctime(const time t * c/oc) ・ 


time.h 


jctime は , ctime の 日 本 語 対 応 版 で , 変換 後 の 文 字 列 は 次 の 形式 に な り ま 
す 。 


1988 年 09 月 23 日 ( 金 ) 07:15:06*nw0 


詳細 に つい て は ctime を 参照 し て くだ さい 。 


変換 後 の 文 字 列 へ の ポイ ンタ を 返し ます 。 


MS-DOS に 特有 の 関数 で す 。 


asctime, ctime, jasctime 


日 本 語 処 理 ラ イプ ラリ 719 


jisalpha 


機能 全角 英文 字 か どう か を 判定 し ます 。 


形式 int jisalpha (unsigned short c) : 


プロ ト タ イ プ jctype.h 


解説 jisalpha は 、c が 全角 英文 字 か どう か を 判定 し ます 。 
(0x8260 ミ c ミ Ox8279 また は Ox8281 < c < Ox829A) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 、 そう で な けれ ば 0 を 返し ます 。 
可 搬性 MS-DOS に 特有 の 関数 で す 。 

jisdigit 

機能 全角 数 字 か どう か を 判定 し ます 。 

形式 int jisdigit (unsigned short c) : 


プロ ト タ イ プ jctype.h 


解説 jisdigit は , c が 全角 数 字 か どう か を 判定 し ます 。 
(0x824F ミ = c ミ Ox8258) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 。 そう で な けれ ば 0 を 返し ます 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 
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jishira 


機能 全角 ひら が な か どう か を 判定 し ます 。 
形式 int jishira (unsigned short c) : 


プロ ト タ イ プ jctypeh 


解説 jiShira は 、 c が 全角 ひら が な か どう か を 判定 し ます 。 
(0x829F = c = Ox82F1) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 。 そう で な けれ ば 0 を 返し ます 。 
可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 jiskana, jiskata 


日 本 語 処 理 ラ イブ ラリ 721 


ニー ニー ニーー。 ニー ニニ ーー。ー。 パ ーー ハハ べべ 
JiSkana 


機能 全角 カタ カナ か どう か を 判定 し ます 。 
形式 int jiSkana (unsigned short c) : 
プロ ト タ イ プ jctypeh 


解説 JiSkana は , c が 全角 カタ カナ か どう か を 判定 し ます 。 
(0x8340 ミ c ミ 8396) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 。 そう で な けれ ば 0 を 返し ます 。 
可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 jishira, jiskata 
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ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー 


jiskata 


機能 全角 カタ カナ か どう か を 判定 し ます 。 
形式 int jiskata (unsigned short c) : 
プロ ト タ イ プ jctypeh 
解説 jiskata は , c が 全角 カタ カナ か どう か を 判定 し ます 。 
(0x8340 Ss c ミ 8396) 
この 関数 は , jjskana と まっ た く 同 じ で す 。 
戻り 値 条件 を 満た せ ば 0 以外 の 値 を . そう で な けれ ば 0 を 返し ます 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 jishira, jiskana 


日 本 語 処理 ライ ブラ リ 723 


ニニ == 
jiskigou 


機能 全角 名 読 点 か どう か を 判定 し ます 。 


形式 int jiSkigou(unsigned short c) : 


プロ ト タ イ プ jctype.h 


解説 jiskigou は , c が 全角 句読点 か どう か を 判定 し ます 。 
(0x8141 ミ c ミ Ox81AC) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 。 そ う で な けれ ば 0 を 返し ます 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


機能 シフ ト JIS コー ド 中 の 漢字 以外 の 文字 か どう か を 判定 し ます 。 


形式 int jisl0 (unsigned short c) : 


プロ ト タ イ プ jctypeh 


解説 jsI0 は ,、 c が シフ ト JIS コー ド の 中 の 漢字 以外 か どう か を 判定 し ます 。 
(0x8140 = c ミ 0x889E) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 。 そう で な けれ ば 0 を 返し ます 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 jisl1, jisl2 
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jisl1 
機能 JIS 第 1 水準 漢字 か どう か を 判定 し ます 。 
形式 int jisI1 (unsigned short c) : 


プロ ト タ イ プ jctypeh 


解説 jisl1 は , c が JIS 第 1 水準 の 漢字 か どう か を 判定 し ます 。 
(0x889F ミ = c ミ 0x9872) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 、 そう で な けれ ば 0 を 返し ます 。 
可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 jisl0, jisl2 


日 本 語 処理 ライ プラ リ 
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機能 JIS 第 2 水準 漢字 か どう か を 判定 し ます 。 
形式 int jisl2 (unsigned short c) ・ 
プロ ト タ イ プ jctypeh 


解説 jisl2 は , c が JIS 第 2 水準 の 漢字 か どう か を 判定 し ます 。 
(0x989F ミ c ミ = OxEA9E) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 、 そ う で な けれ ば 0 を 返し ます 。 
可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 jisl0, jis1 
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ーー 
jislower 


機能 全角 英 小文字 か どう か を 判定 し ます 。 


形式 int jislower (unsigned short c) : 


プロ ト タ イ プ jctypeh 


解説 jislower は 、c が 全角 英 小文字 か どう か を 判定 し ます 。 
(0x8281 ミ c ミ Ox829A) 


戻り 値 条件 を 満た せ ば 0 以外 の 値 を 、 そう で な けれ ば 0 を 返し ます 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 jisupper 


機能 全角 スペ ー ス か どう か を 判定 し ます 。 


形式 int jisspace (unsigned short c) : 


プロ ト タ イ プ jctypeh 


解説 jisspace は 、c が 全角 スペ ー ス か どう か を 判定 し ます 。 

(c = 0x8140) 
戻り 値 条件 を 満た せ ば 0 以外 の 値 を 、 そう で な けれ ば 0 を 返し ます 。 
可 搬性 MS-DOS に 特有 の 関数 で す 。 


日 本 語 処 理 ラ イプ ラリ 727 


jistojms 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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JIS コー ド を シフ ト JIS コー ド に 変換 し ます 。 

unsigned short int jiStojms(unsigned short int c が の : 

jctypeh 

jistojms は , JIS コー ド cz を シフ ト JIS コー ド に 変換 し ます 。 

ce4 の 上 位 バ イト に JIS コー ド の 第 1 バイ ト ,、 cz の 下位 バイ ト に JIS コー ド 


の 第 2 バイ ト が 入っ て いな けれ ば な り ま せん 。 


c4 が JIS コー ド と し て 適切 な 値 で あれ ば , 対応 する シフ ト JIS コー ド を 返 
し ます 。c4 が 適切 で な い 場 合 は 0 を 返し ます 。 


MS-DOS に 特有 の 関数 で す 。 


jmstojis 
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jiSupper 

機能 全角 英 大 文字 か どう か を 判定 し ます 。 

形式 int jisupper (unsigned short c) : 

プロ ト タ イ プ jctypeh 

解説 jiSupper は 、c が 全角 英 大 文字 か どう か を 判定 し ます 。 
(0x8260 ミ c ミ Ox8279) 

戻り 値 条件 を 満た せ ば 0 以外 の 値 を 。 そう で な けれ ば 0 を 返し ます 。 

可 搬性 MS-DOS に 特有 の 関数 で す 。 

関連 項目 jislower 


jiSzen 
機能 全角 文字 か どう か を 判定 し ます 。 
形式 int jiszen (unsigned short c) ・ 
プロ ト タ イ プ jctypeh 
解説 jiSzen は 、c が 全角 文字 か どう か を 判定 し ます 。 
(0x8140 ミ c ミ OxEFFC) 
戻り 値 条件 を 満た せ ば 0 以外 の 値 を 。 そう で な けれ ば 0 を 返し ます 。 
可 搬性 MS-DOS に 特有 の 関数 で す 。 


日 本 馬 処 理 ラ イプ ラリ 729 


jmstojis 


機能 シフ ト JIS コー ド を JIS コー ド に 変換 し ます 。 
形式 unsigned short int jmstojis(unsigned short int c が ) : 
プロ ト タ イ プ jctype.h 
解説 jmstojis は 、 シフ ト JIS コー ド c み を JIS コー ド に 変換 し ます 。 
c4 の 上 位 バ イト に シフ ト JIS コー ド の 第 1 バイ ト , c4 の 下位 バイ ト に シフ 


ト JIS コー ド の 第 2 バイ ト が 入っ て いな けれ ば な り ま せん 。 


戻り 値 c4 が シフ ト JIS コー ド と し て 適切 な 値 で あれ ば , 対応 する JIS コー ド を 返 
し ます 。c4 が 適切 で な い 場合 は 0 を 返し ます 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 jmstojis 
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jstradv 


機能 文字 列 ポ イン タ を 移動 きせ ます 。 
形式 char * jstradv (unsigned char * s, unsigned int z) : 


プ ブ プロトタイプ jstring.h 


解説 jstradv は , s が 指す 文字 列 の ポイ ンタ を n 文字 だ け 移 動 し , その ポイ ンタ 
を 返し ます 。 全 角 文 字 も 1 文字 と し て 数 えま す 。 
指定 し た 文字 数 内 に ヌル 文字 が 現われ た 場合 は 、 その ヌル 文字 を 示す ポイ 
ンタ を 返し ます 。 さら に ヌル 文字 が 漢字 2 バイ ト 目 に あたる 場合 は 、 そ の 前 
の 漢字 第 1 バイ ト 目 も ヌル 文字 と みな し , 第 1 バイ ト 目 を 示す ポイ ンタ を 返 


し ます 。 
戻り 値 ヵ が 1 以上 で あれ ば ポイ ンタ を 返し , 0 の 場合 sy の ポイ ンタ を 返し ます 。 
可 搬 性 MS-DOS に 特有 の 関数 で す 。 


日 本 語 処理 ライ プラ リ 731 


jStrchr 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


732 


文字 列 中 の 指定 文字 の 位置 を 調べ ます 。 

char * jStrchr(char * 5, unsigned short c) : 

jstring.h 

jstrchr は , strchr の 漢字 対応 版 で , 文字 列 c で 指定 され た 文字 を 調べ , 
c が 現われ た 位置 の ポイ ンタ を 返し ます 。 

c に 全角 文字 を 指定 する と き は , 上 位 8 ビッ ト に 漢字 第 1 バイ ト , 下位 8 ビッ 
ト に 第 2 バイ ト が 入り ます 。 半 角 文 字 の と き は , 下位 8 ビッ ト に 値 が 入り , 
上 位 8 ビッ ト は 0 が 入り ます 。 


文字 列 中 で 現われ た c の ポイ ンタ を 返し , 見 つか ら な い 場 合 は NULL ポ 
イン タ を 返し ます 。 


MS-DOS に 特有 の 関数 で す 。 


strchr 
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jstrcmp 


機能 文字 列 を 比較 し ます 。 
形式 int jStrcmp(char * s/,char ** 52) 
プロ ト タ イ プ jstring.h 


解脱 jstremp は , stremp の 漢字 対応 版 で , 全角 文字 も 1 文字 と し て 数 えま す 。 
文字 列 を 比較 する 際 文 字 の 大 小関 係 は , 次 に 指定 する 順番 に な り ま す 。 


ANK く ヵ ナ < 漢字 
戻り 値 stremp を 参照 し て くだ さい 。 
可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 stremp 


日 本 語 処理 ライ ブラリ 733 


jStrlen 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬 性 


関連 項目 
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文字 列 の 文字 数 を 調べ ます 。 

unsigned int jstrlen(char * 5) ・ 

jstring.h 

jstrlen は , 引数 ゞ が 指す 文字 列 の 文字 数 を 返し ます 。 漢 字 も 1 文字 と し て 数 
そま す 。 ヌル 文字 は , 文字 数 に 含ま れ ま せん 。 ま た , ヌル 文字 が 漢字 2 バイ 
ト 目 に あたる 場合 は その 前 の 漢字 第 1 バイ ト 目 も ヌル 文字 と みな し ., 文字 数 
に は 含め ませ ん 。 

5 の 文字 数 を 返し ます 。 


MS-DOS に 特有 の 関数 で す 。 


strlen 
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jstrmatch 


機能 strpbrk の 漢字 対応 版 で す 。 


形式 char * jstrmatch(char * 7,char * 52) : 


プロ ト タ イ プ jstring.h 


解説 jstrmatch は , strpbrk の 漢字 対応 版 で す 。 引 数 s/, s2 と も に 漢字 を 使用 
する こと が で きま す 。 


戻り 値 37 の 中 で , 52 の 文字 列 内 に 含ま れる 文字 の どれ か が 最初 に 現われ た 位置 を 
指す ポイ ンタ を 返し ます 。 一 致す る 文字 が な い 場 合 に は , NULL ポイ ンタ 
を 返し ます 。 

可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 strpbrk 


日 本 語 処理 ライ プラ リ 735 


jstrncat 


機能 strncat の 漢字 対応 版 で す 。 

形式 char * jStrncat(char * s7, char * s2, unsigned int ヵ ) : 

プロ ト タ イ プ jstring.h 

解説 jstrncat は , strncat の 漢字 対応 版 で , 漢字 を 1 文字 と し て 数 える こと を 除 
いて , まっ た く 同 処理 を 行ない ます 。 漢字 の 第 2 バイ ト 目 が ヌル 文字 で あ 
れ ば , その 前 の 第 1 バイ ト 目 も ヌル 文字 と みな され ます 。 

戻り 値 strncat を 参照 し て くだ さい 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 strncat 
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jstrncmp 


機能 strncmp の 漢字 対応 版 で す 。 

形式 char * jStrncmp(char * 57, char * 52,unsigned int ヵ ) : 

プロ ト タ イ プ jstring.h 

解説 jstrncmp は 、 strnemp の 漢字 対応 版 で , 漢字 を 1 文字 と し て 数 える 他 は 同 
処理 を し ます 。 漢 字 の 第 2 バイ ト 目 が ヌル 文字 で あれ ば , その 前 の 第 1 バ 
イト 目 も ヌル 文字 と みな され ます 。 文字 列 を 比較 する 際 , 文字 の 大 小関 係 
は 以下 に 指定 する 順番 に な り ま す 。 

ANK 文字 く カナ 文字 < 漢字 
戻り 値 strncmp を 参照 し て くだ さい 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 strncmp 


日 本 語 処 理 ラ イブ ラリ 73Z 


jstrncpy 


機能 strncpy の 漢字 対応 版 で す 。 
形式 char * jStrncpy (char * 5/, char * 2, unsigned int ヵ ) 


プロ ト タ イ プ jstring.h 


解説 jstrncpy は , strncpy の 漢字 対応 版 で , 漢字 を 1 文字 と し て 数 える 他 は 同じ 
処理 を し ます 。 漢 字 の 第 2 バイ ト 目 が ヌル 文字 で あれ ば , その 前 の 第 1 バイ 
ト 目 も ヌル 文字 と みな され ます 。 

戻り 値 strncpy を 参照 し て くだ さい 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 strncpy 
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JStrrchr 


機能 strrchr の 漢字 対応 版 で す 。 

形式 char * jstrrchr(char * 5, unsigned int c) : 

プロ ト タ イ プ jstring.h 

解説 jstrrchr は , strrchr の 漢字 対応 版 で , 文字 列 s で 指定 され た 文字 列 を 調べ 
て , c が 最後 に 現われ た 位置 を 指す ポイ ンタ を 返し ます 。c に 全角 文字 を 指 
定 す る と き は , 下位 8 ビッ ト に 漢字 第 1 バイ ト , 下位 8 ビッ ト に 第 2 バイ ト が 
入り ます 。 半角 文字 の と き は , 下位 8 ビッ ト に 値 が 入り 、 上 位 8 ビ ッ ト は 0 が 


入り ます 。 


戻り 値 文字 列 中 で 最後 に 現われ た c へ の ポイ ンタ を 返し , 見 つか ら な い 場 合 は 
NULL ポイ ンタ を 返し ます 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 strrchr 


日 本 語 処 理 ラ イブ ラリ 739 


JStrrev 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 


関連 項目 
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strrev の 漢字 対応 版 で す 。 


char * jstrrchr(char * s) : 


jstring.h 


jstrrchr は 、 strrev の 漢字 対応 版 で , 文字 列 s に 全角 文字 が 使え ます 。 


strrev を 参照 し て くだ さい 。 


MS-DOS に 特有 の 関数 で す 。 


strrev 
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jstrskip 


機能 指定 文字 列 内 に 検索 文字 列 に 含ま れ な い 文 字 が ある か 調べ ます 。 


形式 char * jStrskip(char * s7,char * 52) 


プロ ト タ イ プ jstring.h 


形式 jstrskip は , 文字 列 s7 内 に , 文字 列 s2 中 に 含ま れ て いな い 文 字 が あっ た 場 
合 , その 文字 を 指す ポイ ンタ を 返し ます 。 引数 7/, s2 と も に 全角 文字 を 使 
用 で きま す 。57 の 文字 列 内 に ヌル 文字 が あれ ば , その ヌル 文字 を 指す ポイ 


ンタ を 返し ます 。 

戻り 値 37 の 中 で , 52 に 含ま れ な い 文 字 が 現われ た 位置 を 示す ポイ ンタ を 返し ま 
k 

可 搬性 MS-DOS に 特有 の 関数 で す 。 


日 本 馬 処 理 ラ イプ ラリ 741 


jstrstr 


機能 strstr の 漢字 対応 版 で す 。 


形式 char * jstrstr(char * s7,char * 52) 


プロ ト タ イ プ jstring.h 


形式 jstrstr は strstr の 漢字 対応 版 で , 引数 s/ と s2 に 全角 文字 が 使え ます 。 
戻り 値 strstr を 参照 し て くだ さい 。 
可 搬 性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 strstr 


jstrtok 
機能 strtok の 漢字 対応 版 で す 。 
形式 char * jstrtok(char * 57,char ※ 52) : 


プロ ト タ イ プ jstring.h 


解説 jstrtok は , strtok の 漢字 対応 版 で 引数 s/, s2 に 全角 文字 が 使え ます 。 
戻り 値 strtok を 参照 し て くだ さい 。 
可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 strtok 
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jtohira 


機能 全角 カタ カナ を 全角 ひら が な に 変換 し ます 。 


形式 unsigned short jtohira (unsigned short c) : 


プロ ト タ イ プ jctypeh 


解説 jtohira は , 全角 カタ カナ を 全角 ひら が な に 変換 し ます 。 
c に は 全角 文字 コー ド を 指定 する こと が で きま す 。 


戻り 値 変換 が 正しく 行なわ れれ ば 変換 され た 文字 コー ド を 返し ます 。 変 換 で き な 
いと き に は , c の 値 を その まま 返し ます 。 


可 搬 性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 jtokana, jtokata 


日 本 証 処 理 ラ イプ ラリ 743 


jtokana 


機能 全角 ひら が な を 全角 カタ カナ に 変換 し ます 。 
形式 unsigned short jtokana (unsigned short c) : 
プロ ト タ イ プ jctype.h 


解説 jtokana は 、 全角 ひら が な を 全角 カタ カナ に 変換 し ます 。 
c に は 全角 文字 コー ド を 指定 する こと が で きま す 。 


戻り 値 変換 が 正しく 行なわ れれ ば , 変換 され た 文字 コー ド を 返し ます 。 変 換 で き 
な いと き に は , c の 値 を その まま 返し ます 。 


可 搬 性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 jtohira, jtokata 
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jtokata 


機能 全角 ひら が な を 全角 カタ カナ に 変換 し ます 。 

形式 unsigned short jtokata (unsigned short c) : 

プロ ト タ イ プ jctypeh 

解説 jtokana は , 全角 ひら が な を 全角 カタ カナ に 変換 し ます 。 
c に は 全角 文字 コー ド を 指定 する こと が で きま す 。 


この 関数 は , jtokana と まっ た く 同 じ で す 。 


戻り 値 変換 が 正しく 行なわ れれ ば , 変換 され た 文字 コー ド を 返し ます 。 変 換 で き 
な いと き に は , c の 値 を その まま 返し ます 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 jtohira, jtokana 


日 本 語 処 理 ラ イプ ラリ 745 


jtolower 


機能 全角 英 大 文字 を 全角 英 小文字 に 変換 し ます 。 
形式 unsigned short jtolower (unsigned short c) : 
プロ ト タ イ プ jctypeh 


解説 jtolower は , 全角 英 大 文字 を 全角 英 小文字 に 変換 し ます 。 
c に は 全角 文字 コード を 与え ます 。 


戻り 値 変換 が 正しく 行なわ れれ ば , 変換 され た 文字 コー ド を 返し ます 。 変 換 で き 
な いと き に は c の 値 が その まま 返り ます 。 


可 搬 性 MS-DOS に 特有 の 関数 で す 。 
関連 項目 jtoupper, tolower 
746 
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]jtoupper 


機能 全角 英 小文字 を 全角 英 大 文字 に 変換 し ます 。 
形式 unsigned short jtoupper(unsigned short c) : 
プロ ト タ イ プ jctype.h 


解説 jtoupper は , 全角 英 小文字 を 全角 英 大 文字 に 変換 し ます 。 
c に は 全角 文字 コード を 与え ます 。 


戻り 値 変換 が 正しく 行なわ れれ ば , 変換 され た 文字 コー ド を 返し ます 。 変 換 で き 
な いと き に は c の 値 が その まま 返り ます 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 jtolower, toupper 


日 本 語 処理 ライ プラ リ 74Z 


mtob 


機能 


形式 


プロ ト タ イ プ 


戻り 値 


可 搬性 
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文字 列 の 先頭 か ら zzzo7f まで に 存在 する バイ ト 数 を 調べ ます 。 

unsigned int mtob(char * sg, int が の 7 が) : 

jString.h 

mtob は 引数 szg が 指す 文字 列 の 先頭 か ら zo77 個 の 文字 が 何 バ イト 
を 占め る か を 調べ ます 。 全 角 文 字 は 2 バイ ト と し て 数 えま す 。 

指定 し た 文字 数 以内 に ヌル 文字 が 現われ た 場合 は 、 その ヌル 文字 の 直前 ま 
で の バイ ト 数 を 返し ます 。 さ ら に ヌル 文字 が 漢字 の 第 2 バイ ト 目 に あたる 場 
合 は , その 直前 の 漢字 第 1 バイ ト 目 も ヌル 文字 と みな し て バイ ト 数 に は 含め 
ませ ん 。 

zz の 7 が 1 以上 で あれ ば バイ ト 数 を 返し 、 0 の 場合 は 0 を 返し ます 。 


MS-DOS に 特有 の 関数 で す 。 


btom 
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nthctype 


機能 文字 列 内 の z の yre の 位置 に ある 文字 タイ プ を 調べ ます 。 


形式 #include <jctype.h> 
unsigned int nthctype(char * sg, unSigned int z の yre) : 


プロ ト タ イ プ jctype.h 


解説 nthctype は , 引数 s7ing 文字 列 内 の zbyfe ( ヵ バ イト 目 ) の 位置 に ある 文 
字 タ イプ を 調べ ます 。 文 字 列 の 先頭 を 指定 する 際 は , zpye は 0 に な り ま 
す 。 

戻り 値 文字 タイ プ を 判定 し て 文字 の 属性 に より 以下 の 値 を 返し ます 。 


戻り 値 値 意味 


CT_ANK 0 ANK 文字 
CT_KJ1 1 漢字 の 第 1 バイ ト 
CT _KJ2 2 漢字 の 第 2 バイ ト 
CT_ILGL -1 無効 な セク イプ 


無効 を タク イプ と は , 漢字 の 第 2 バイ ト が iskanji2 で な いり 場合 を 意味 し ます 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


日 本 馬 処 理 ラ イプ ラリ 749 


Zentohan 


機能 全角 文字 を 半角 文字 に 変換 し ます 。 
形式 unsigned short zentohan (unsigend short c) : 
プロ ト タ イ プ jctypeh 


解説 zentohan は 、 全角 文字 c を 半角 に 変換 し ます 。 変換 が 行なわ れる の は , 半 
角 文 字 が 0x20 一 Ox7e の 男 囲 に 限ら れ ま す 。 


戻り 値 Zentohan は , 変換 が 正しく 行なわ れれ ば , 変換 後 の 文字 コー ド を 返し ま 
す 。 変 換 で き な か っ た 場合 に は , c を その まま 返し ます 。 


可 搬性 MS-DOS に 特有 の 関数 で す 。 


関連 項目 hantozen 
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Turbo C の コン バイ ル 診 断 メ ッ セ ー ジ は , 致命 的 な エラ ー (Fatal error), エラ ー 
(Error)、 警告 (Warning) の 3 つの クラ ス に 分 類 さ れ ま す 。 

致命 的 な エラ ー が 出る こと は まれ で , コン バイ ラ 内 部 で の エラ ー を 示す 場合 が ほとん ど 
で す 。 致命 的 な エラ ー が 検出 され る と , コン バイ ル は た だ ち に 中 止 さ れ ま す 。 こ の よう な 
場合 は 、 適当 な 処置 を し て か ら , も う 一 度 コ ン パ イル を 行なっ て くだ さい 。 

エラ ー は , プロ グラ ム の 構文 の 誤り ,、 ディ スク エラ ー や メモ リア クセ スエ ラー, コマ ン 
ドラ イン の 誤り を 指摘 する も の で す 。 コ ン バ パイ ラ は 現在 行なっ て いる フェ ー ズ が 終わ っ た 
段階 で 停止 し ます 。 コ ン パ イル の 各 フ ェ ー ズ (前 処理 解析 、 最適 化 、 コ ー ド 生成 ) で は , 
可能 な 限り 多く の エラ ー が 検出 され ます 。 

警告 が 検出 され て も ,、 コン バイ ル は 中 止 さ きれ ませ ん 。 問題 は ある けれ ども , 文法 的 に は 
間違っ て いな い 場 合 に 、 警告 メッセ ー ジ が 出力 され ます 。 ま た , プロ グラ ム 中 に マシ ン に 
依存 し そう な 部 分 を 見 つけ た 場合 に も 警告 メッ セー ジ を 出力 し ます 。 

コン パイ ラ は , メッ セー ジ の 先頭 に エラ ー の クラ ス (Fatal error, Error, Warning) 
を 表示 し , 次 に エラ ー を 検出 し た ファ イル の 名 前 と 行 番号 , 最後 に メッ セー ジ そ の も の を 
表示 し ます 。 

以下 で は , 各 ク ラス ご と に アル ファ ベッ ト 順 に メッ セー ジ を 示し , 考え られ る 原因 と 対 
策 も あわ せ て 示し ます 。 な お , この リス ト 内 の メッ セー ジ の 中 の 'XXXXXXXX' は 。 実際 
の メッ セー ジ で は ソー スコ ー ド て で 使わ れ て いる 識別 名 や ファ イル 名 に 置き 換え られ ます 。 
エラ ー メ ッ セ ー ジ の 行 番号 に つい て は 注意 し な けれ ば な ら な いこ と が あり ます 。C で は , 
1 行 の 中 に 文 を どの よう に 書く か に つい て は 制限 が な い の で , 実質 的 な を エラー の 原因 は , 指 
摘 さ れ た 行 番号 より 前 に ある 場合 が し ば し ば あり ます 。 以 下 の リ スト で も , 実質 的 な 原因 
より も 後 で 検出 され が ちな メッ セー ジ に つい て は 、 な る べく それ を 指摘 する よう に し て い 
ます 。 
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致命 的 な エラ ー (Fatal) 


Bad call of imn-line function 
マク ロ 定 義 か ら イ ン ラ イン 関数 を 取り 出し て 使用 し て いま す が , 正しく 呼び 出し て い 
ませ ん 。 イ ン ラ イン 関数 は 、2 つ の 連続 し た 下線 ( _) で 始ま りか つ 終わ っ て いる も の 
で お 。 


Irreducible expression tree 
これ は コン バイ ラ 自 身 の エ ラー を 表わす も の で す 。 ソ ー ス ファ イル の 指摘 され た 行 に , 
コー ド 生 成 の フェ ー ズ で , コー ド を 作り 出す こと が で き な い 式 が 存在 し ます 。 そ の 式 
に な ん ら か の 原因 が 考え られ る 場合 は 、 その 式 は 取り 除く べき で す 。 こ の エラ ー ガ が 出 
た 場合 は 、MSA カス タマ ー サ ポー ト セン ター に 連絡 し て くだ さい 。 


Register allocation failure 
これ は コン バイ ラ 自 身 の エ ラー を 表わす も の で す 。 ソ ー ス ファ イル の 指摘 され た 行 に , 
コー ド 生 成 の フェ ー ズ で , コー ド を 作り 出す こと が で き な い 式 が 存在 し ます 。 そ の 式 
に な ん ら か の 原因 が 考え られ る 場合 は 、 式 を 単純 な も の に し て くだ さい 。 そ れ で も う 
まく いか な い 場 合 は 、 そ の 式 は 取り 除く べき で す 。 この エラ ー が 出 た 場合 は , MSA カ 
スタ マー サポ ー ト セン ター に 連絡 し て くだ さい 。 
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エラ フラー 


#operator not followed by macro argument mame 
マク ワ 定 義 に お いて ,# は マク ロ 引数 を 文字 列 に する こと を 指示 する た め に 使う こと が 
で きま す 。# の 後に は マク ロ 引 数 名 が 続か な けれ ば な り ま せん 。 


XXXXXXXX' not an argument 
ソー ス フ ァ イル の 中 で , 指摘 され た 識別 名 が 関数 の 引数 と し て 便 言 され て いま す が , 
関数 引数 リス ト に その 識別 名 が あり ませ ん 。 


Ambiguous symbol "XXXXXXXX* 
構造 体 の フィ ー ル ド 名 が , 複数 の 構造 体 の 中 で , 異な る オフ セッ ト , ある い は 異な る 
型 、 ま た その 両方 で 使わ れ て いま す 。 そ の フィ ー ル ド を 参照 する た め に 使わ れ た 変数 
また は 式 が , その フィ ー ル ド を 含む 構造 体 を 示し て いま せん 。 構 造 体 を 正しい 型 に キ 
ャ スト する か , フィ ー ル ド 名 が 間違っ て いる の で あれ ば 正しい も の に 修正 し て くだ さ 


い 。 


Argument # missing name 
関数 の 定義 に 使用 され た 関数 プロ ト タイ プ に お いて , 引数 名 が 省略 され て いま す 。 関 
数 を プロ ト タ イ プ て 定義 する 場合 、 プ ロト タイ プ に は 引数 名 を 書か な けれ ば な り ま せ 
ん 。 


Argument list syntax error 
関数 を 呼び 出す 際 の 引数 は , カン マ で 区 切り , 最後 は 有 有 カッコ)" で 閉じ し な けれ ば な り 
ませ ん 。 ソ ー ス コー ド 中 の 引数 の 後に 。 カ ンマ ある い は 右 カッ コ 以 外 の 文字 が 続い て 
いま す 。 


Array bounds missing ] 
ソー ス フ ァ イル 中 で 配列 が 宣言 され て いま す が , 配列 の 範囲 が 右 大 カ ッ コ ]' で 閉じ ら 
れ て いま せん 。 


Array size too large 
宣 言 され た 配列 が 大 きす ぎ て , メモ リ に お さま り ま せん 。 
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Assembler statement too long 
イン ライ ン ア セン プリ 文 が 480 バ イト を 越え を て し まい ます 。 


Bad configuration file 
TURBOC.CFG ファ イル の 中 に , コメ ント で な い テ キス ト で , コマ ンド ライ ン オ プシ 
ョ ン と し て 正しく な いも の が あり ます 。 コ マン ドラ イン オプ ショ ン は , マイ ナス 符号 
(-) で 始ま っ て いな けれ ば な り ま せん 。 


Bad file name format in include directive 
イン クル ー ド され る ファ イル 名 は , 二 重 引用 待 ("7Meggze/") また は 不 等 号 
( ぐ ⑦ezg7ze. め ) で 囲ま れ て いな けれ ば な り ま せん 。 フ ァイル 名 の 左側 に その どちら か 
が つけ られ て いま せん 。 マ クロ が 使わ れ て いる 場合 は , 展開 され た テキ スト が 正しく 
あり ませ ん 。 


Bad ifdef directive syntax 
#ifdef 指令 は , 指令 の 本 体 と し て は , 識別 名 は 1 個 し か 含む こと は で きま せん 。 


Bad ifndef directive syntax 
#ifndef 指令 は 。 指令 の 本 体 と し て は , 識別 名 は 1 個 し か 含む こと は で きま せん 。 


Bad undef directive syntax 
#undef 指令 は , 指令 の 本 体 と し て は 、 識別 名 は 1 個 し か 含む こと は で きま せん 。 


Bit field size syntax 
ビッ ト フ ィ ー ル ド の 幅 は , 1 一 16 の 間 の 定数 で 定義 し な けれ ば な り ま せん 。 


Call of non-fanction 
関数 と し て 定 言 さま れ て いな いも の を 呼び 出し て いま す 。 こ れ は , 関数 の 宣言 が 正しく 
な いか , 関数 名 を スペ ルミ ス し た こと に 原因 が あり ます 。 


Cannot modify a const object 


const と 宣言 され た オプ ジェ クト に 対し て , 代入 な どの 許さ れ な い 操作 が 行なわ れ て 
いま す 。 
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Case outside of switch 
switch 文 の 外側 に case 文 が あり まし た 。 お そら く や で と が 正しく 対応 し て いま せん 
(どちら か が な い )。 


Case statement missing : 
case 文 で は , 定数 式 の 後に コロ ン ( : ) が 必要 で す 。case 文 の 式 に コロ ン を つけ る の 
を 忘れ た か , コロ ン の 前 に よけい な シン ボル が つい て いる は ず で す 。 


Cast syntax error 
キャ スト が 正しく な い シ ン ボ ポル を 含ん で いま す 。 


Character constant too long 
文字 定数 は 、 1 文字 か 2 文字 の 長 さ し か 許さ れ ま せん 。 


Compound statement missing ) 
ソー ス フ ァ イル の 終わ り ま で 達し た の に , 右 カ ッ コ !' が あり ませ ん で し た 。 おそらく" 
で と りす が 正しく 対応 し て いな いこ と に より ます 。 


Conflicting type modifiers 
これ は , 1 つの ポイ ンタ の 宣言 で , 子 約 語 near と far の 両方 を 指定 し た と き な ど に 出 
カカ され ます 。1 つ の ポイ ンタ に は 1 つの アド レシ ング 修飾 子 。1 つ の 関数 に は 1 つの 言語 
修飾 子 (cdecl、pascal また は interrupt) し か 指定 で きま せん 。 


Constant expression required 
配列 は 定数 の 大 き さ で 宣言 まれ な けれ ば な り ま せん 。 こ の エラ ー は ,#define 定数 の ス 
ペル ミス に よっ て よく 起こ り ま す 。 


Could not find file "XXXXXXXX.XXX* 
コマ ンド ライ ン て 指定 され た ファ イル が 見 つか り ま せん で し た 。 


Declaration missing : 


ソー ス フ ァ イル の 中 に , 最後 に モミ コロ ン (: ) の な い struct また は union の フィ ー 
ルド 宜 言 が 含ま れ て いま す 。 
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Declaration needs type or storage class 
定 言 に は , 少な く と も 型 か 記憶 クラ ス の 指定 が 必要 で す 。 た と えば , 次 の よう な 全 言 
文 は 正しく あり ませ ん 。 


PH 


Declaration syntax error 
ソー ス フ ァ イル の 中 に , シン ボル が 欠け て いる , ある い は よけい な シン ボル を 含む 家 
言 が あり ます 。 


Default outside of switch 
switch 文 の 外側 に default 文 が あり まし た 。 お そら く や で と すず が 正しく 対応 し て いま せ 
ん 。 


Define directive needs an identifier 
#define の 後 の ( ホ ワイ トス ペー ス 以 外 の ) 最初 の 文字 は , 識別 名 で な けれ ば な り ま せ 
ん 。 識 別名 と は 考え られ な い 文 字 が あり まし た 。 


Division by zero 
ソー ス フ ァ イル の 中 に , ゼロ で 割る 式 が あり ます 。 


Do statement must have while 
do 文 の 中 に , 予約 語 while が あり ませ ん 。 


Do-while statement missing ( 
do 文 の 中 で , 了 予約 語 while の 後に 左 カ ッ コ "(が あり ませ ん 。 


Do-while statement missing ) 
do 文 の 中 で , 条件 式 の 右 カ ッ コ "が あり ませ ん 。 


Do-while statement missing : 
do 文 の 中 で , 条件 式 の 右 カ ッ コ の 後に セミ コロ ン (: ) が あり ませ ん 。 


Duplicate case 
switch 文 の 各 case の 定数 式 は 、 他 の case と 異な る も の で な けれ ば な り ま せん 。 
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Enum syntax error 
enum 定 言 の 識別 名 の 並び が 正しく あり ませ ん 。 


Enumeration constant syntax error 
enum の 値 と し て 与え られ て いる 式 が 定数 で は あり ませ ん 。 


Error Directive : XXXX 
この メッ セー ジ は , ソー ス フ ァ イル 中 の #error 指令 が 実行 され た と き に 表示 され ま 
す 。 指令 の テキ スト が メッ セー ジ の 中 に 表示 され ます 。 


Error writing output file 
この エラ ー は 。 作業 用 ディ スク が いっ ぱい に な っ た 場合 に よく で ます 。 デ ィ ス ケッ ト 
が 壊れ て いる よう な 場合 に もち で ます 。 い っ ぱい の 場合 は , 不要 な ファ イル を 消去 し て , 
も う 一 度 コ ン パ イル を 行なっ て くだ さい 。 


Expression syntax 
式 の 解析 に お いて 重大 な エラ ー が あっ た 場合 に 、 こ の メッ セー ジ が 出力 され ます 。 2 つ 
の 演算 子 が 連続 し て 現われ た り , カッ コ の 対応 し て いな か っ た り , 前 の 文 の セミ コロ 
ン が な い 場 合 な ど で す 。 


Extra parameter in call 
プロ ト タ イ プ で 定義 され た ポイ ンタ に よる 関数 呼び 出し で , 引数 が 多 す ぎ ま す 。 


Extra parameter in call to XXXXXXXX 
(プロ ト タ イ プ で 人 富 言 され た ) 関数 の 呼び 出し で , 引数 が 多 す ぎ ま す 。 


File name too long 
#include 指令 で 指定 され た ファ イル 名 が 長 す ぎ て , コン バイ ラ が 処理 で きま せん 。 
MS-DOS に お ける ファ イル 名 は 64 文 字 以 下 で な けれ ば な り ま せん 。 


For statement missing ( 
for 文 で , for の 後に 左 カ ッ コ "(が あり ませ ん 。 


For statement missing ) 
for 文 で , 制御 式 の 後に 右 カ ッ コ )' が あり ませ ん 。 
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For statement missing ・ 
for 文 で 、 式 の 後に モミ コロ ン ': "が あり ませ ん 。 


Function call missing ) 
関数 呼び 出し の 引数 の 並び に 構文 エラ ー が あり ます 。 た と えば , 右 カッ コ の 指定 を 忘 
れ た り し た 場合 で す 。 


Function definition out of place 
関数 定義 は , 他 の 関数 の 内 部 に 置く こと は で きま せん 。 関 数 の 内 部 に ある , 引数 リス 
ト を と も な う 関 数 の 始ま り の よう な 宣言 は , 関数 定義 と みな され ます 。 


Function doesn't take a variable mumber of arguments 
可変 個 の 引数 を と る こと が で き な い 関数 で , va _start マ クロ が 使用 され て いま す 。 


Goto statement missing label 
予約 語 goto の 後に は , 識別 名 が 必要 で す 。 


If statement missing ( 
if 文 に お いて , 予約 語 if の 後に 左 カ ッ コ '( が あり ませ ん 。 


If statement missing ) 
if 文 に お いて , 条件 式 の 後に 有 カッ コ ')'" が あり ませ ん 。 


Illegal character 'C'(OxXX) 
入力 ファ イル の 中 に 無効 な 文字 が 使わ れ て いま す 。 そ の 文字 の 16 進 値 も 表示 され ます 。 


Illegal initialization 
初期 化 は 、 定 数 式 、 また は , グロ ー バ ル な 外部 (extern) 変数 ある い は static 変数 の 
アド レス に 定数 を 足す か 。 引く か し た も の で な けれ ば な り ま せん 。 


Illegal octal digit 
8 進 定数 の 中 に , 8 進数 字 と し て は 許さ れ な い 数 字 (8 また は 9) が あり ます 。 


Illegal pointer subtraction 
これ は , ポイ ンタ で な いも の か ら ポ イン タ を 引 こ うと し た と き に 出力 され ます 。 
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Illegal structure operation 
構造 体 に 使用 で きる 演算 子 は , ピリ オド (.), アド レス of 演算 子 (&), 代入 演算 子 ( 三 ) 
で あり , また 構造 体 は 関数 へ の (か ら の ) 引数 と し て 指定 で きま す 。 構 造 体 が これ 以 
外 の 演算 子 と と も に 使用 され て いる と , この エラ ー が 出 ます 。 


Illegal use of floating point 
浮動 小数 点 オ ペラ ンド に 対し て ,、 シフ ト , ビッ ト 論 理 演算 , 条件 式 (? :), 間接 参 
照 (*) な どの 演算 を 行なう こと は で きま せん 。 浮動 小数 点 オ ペラ ンド が , これ ら の 
使用 で き な い 演算 子 と と も に 使わ れ て いま す 。 


Illegal use of pointer 
ポイ ンタ に 対し て は 、 加算 減算 , 代入 , 関係 , 間接 (*), 矢印 (-〉) の 演算 子 し か 
使用 で きま せん 。 ソ ー ス ファ イル の 中 で , ポイ ンタ が 他 の 演算 子 と と も に 使わ れ て い 
ます 。 


Improper use of a typedef symbol 
式 の 中 で , typedef 名 が , 変数 を 置く べき 場所 に 使わ れ て いま す 。 typedef 宣言 と スペ 
ルミ ス が な いか どう か チェ ッ ク し て くだ さい 。 


In-line assembly not allowed 
ソー ス フ ァ イル に は イン ライ ン ア セン プリ 文 が 含ま れ て いま す が , それ を 統合 環境 の 
中 か ら コ ン パ イル し よう と し て いま す 。 こ の ソー ス フ ァ イル を コン パイ ル す る に は , 
TCC コマ ンド を 使用 する 必要 が あり ます 。 


Incompatible storage class 
ソー ス フ ァ イル の 中 で , 関数 定義 に 対し て 耶 約 語 extern が 使わ れ て いま す 。 関数 定義 
に は , 記憶 クラ ス と し て は , 何 も な し か , つけ る と すれ ば static し か 使用 で きま せん 。 


Incompatible type conversion 
ある 型 か ら 別 の 型 へ の 変換 を し よう と し て いま す が , この 2 つの 型 は コン パチ ブル で は 
あり ませ ん 。 これ に は , 関数 と 非 関数 の 間 , 構造 体 や 配列 と スカ ラ 型 の 間 、 浮動 小 数 
点 値 と ポイ ンタ 型 の 間 な どの 変換 が 含ま れ ま す 。 


Incorrect command line argument : XXXXXXXX 
この コマ ンド ライ ン 引 数 は , 正当 な も の と は 認め られ ませ ん 。 
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Incorrect confiugration file argument : XXXXXXXX 
コン フィ ギュ レー ショ ン フ ァイル 内 の この 引数 は , 正当 な も の と は 認め られ ませ ん 。 
特に , マイ ナス 符号 (-) が つい て いる か チェ ッ ク し て くだ さい 。 


Incorrect number format 
16 進 表記 の 中 に 小数 点 が 現われ まし た 。 


Incorrect use of default 
予約 語 default の 後に コロ ン ( : ) が あり ませ ん 。 


Initializer syntax error 
初期 化 に お いて , 演算 子 が た りな い , 余計 な 演算 子 が ある 、 カッコ が 正しく 対応 し て 
いな い , な ど 書 式 と し て 受け 入れ られ ませ ん 。 


Invalid indirection 
間接 演算 子 (*) の オペ ラン ド は , void で は な い ポ イン タ で な けれ ば な り ま せん 。 


Invalid macro argument separator 
マク ロ 定 義 内 の 引数 は , カン マ で 区 切ら れ て いな けれ ば な り ま せん 。 引 数 名 の 後に 別 
の 文字 が あり まし た 。 


Inyalid pointer addition 
2 つの ポイ ンタ を 足し 合わ せよ うと し て いま す 。 


Invaild use of arrow 
矢印 演 算 子 (-〉) の 後ろ に は , 識別 名 を 置か な けれ ば な り ま せん 。 


Invaild use of dot 
ドッ ト 演 算 子 (.) の 後ろ に は , 識別 名 を 置か を けれ ば な り ま せん 。 


Lvalue required 
代入 演算 子 の 左辺 は , 値 を 代入 する アド レス が 特定 で きる 式 で な けれ ば な り ま せん 。 
これ に は 、 数 値 変数 , ポイ ンタ 変数 構造 体 フィ ー ル ド 参 照 、 ポ イン タ に よる 間接 参 
照 , 配列 要素 な ど が 含ま れ ま す 。 
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Macro argument syntax error 
マク ロ 定 義 に お ける 引数 は 識別 名 で な けれ ば な り ま せん 。 引 数 が 現われ る べき 位置 に 
識別 名 に は 許さ れ な い 文 字 が 使わ れ て いま す 。 


Macro expansion too long 
マク ロ は 4096 文 字 以 上 に 展開 する こと は で きま せん 。 こ の エラ ー は , マク ロ が それ 自 
身 を 再帰 的 に 展開 し よう と する 場合 に 起こ り ま す 。 マ クロ は 自分 自身 を 正しく 展開 す 
る こと は で きま せん 。 


May compile omly one file when an output file name is given 
コマ ンド ライ ン オ プシ ョ ン -o を 指定 する と 出力 ファ イル は 1 個 の み と な る の で , 先頭 
の ファ イル だ けが コン バイ ル さ れ , 他 の ファ イル は コン バイ ル さ れ ま せん 。 


Mismatched number of parameters in definition 
関数 定義 に お ける 引数 が , 関数 プロ ト タ イ プ で 与え られ た 情報 と 一 致し ませ ん 。 


Misplaced break 
switch 文 の 外側 。 あるいは ルー プ の 外側 に break 文 が あり ます 。 


Misplaced continue 
switch 文 の 外側 、 あ る い は ルー プ の 外側 に continue 文 が あ り ます 。 


Misplaced decimal point 
浮動 小数 点 定 数 の 指数 部 に 小数 点 が あり ます 。 


Misplaced else 
ぜ 文 と 対応 し な い else 文 が あり ます 。 こ れ は , 単に よけい な else が ある 場合 の 他 に , 
よけい な セミ コロ ン が ある , やり "を 入れ 忘れ て いる , 前 の if 文 の 中 に 構文 エラ ー が 
ある 場合 な ど に 起こ り ま す 。 


Misplaced elif directive 
#i、#ifdef, #ifndef に 対応 し な いま elif 指令 が あり ます 。 
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Misplaced else directive 
# 下 #ifdef、#ifndef に 対応 し な い #else 指令 が あり ます 。 


Misplaced endif directive 
#if、#ifdef, #ifndef に 対応 し な い #endif 指令 が あり ます 。 


Must be addressable 
& 演 算 子 が , 特定 の アド レス に 置か れ な い オ プ ジ ェ クト , た と えば レジ スタ 変数 な ど に 
使用 され て いま す 。 


Must take address of memory location 
アド レス of 演算 子 (&) が 式 の 中 で , 許さ れ な い 使い 方 を され て いま す 。 た と えば 、 
レジ スタ 変数 な ど に 対し て 使用 きれ て いま す 。 


No file name ending 
#include 文 の ファ イル 名 を 閉じ る 不 等 号 (〉) ある い は 二 重 引用 符 () が あり ませ 
ん 。 


No file name given 
TurboC の コン バイ ラ (TCC) に , ファ イル 名 が 指定 され て いま せん 。 ソ ー ス ファ イ 
ル 名 を 指定 し な けれ ば な り ま せん 。 


Non-portable pointer assignment 
ソー ス フ ァ イル の 中 に ,、 ポイ ンタ を ポイ ンタ で な いも の へ 代入 する 文 , ある い は その 
逆 の 代入 を 行なう 文 が あり ます 。 特殊 な ケー ス と し て , 定数 0 を ポイ ンタ に 代入 する こ 
と は 許さ れ て いま す 。 代 入 そ の も の が 適切 な の で あれ ば , この エラ ー メ ッ セ ー ジ か 出 
な いよ うに する た め に , キャ スト を 使用 し て くだ さい 。 


Non-portable pointer comparison 
ソー ス フ ァ イル の 中 で , ポイ ンタ と ポイ ンタ 以外 の も の と の 比較 が 行なわ れ て いま す 。 
ポイ ンタ は , ポイ ンタ 以外 の も の で は 定数 0 と し か 比較 で きま せん 。 比較 その も の が 適 
切な の で あれ ば , この エラ ー メ ッ セ ー ジ が 出 な いよ うに する た め に , キャ スト を 使用 
し て くだ さい 。 
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Non-portable return type conversion 
return 文 の 中 の 式 の 型 が , 関数 宜 言 の 型 と 一 致し て いま せん 。 1 つの 例外 を 除い て , 関 
数 また は return 文 の 式 が ポイ ンタ の 場合 に は この エラ ー が で ます 。 例外 は , ポイ ンタ 
を 返す 関数 が 定数 0 を 返す 場合 で す 。0 は 適切 な ポイ ンタ 値 に 変換 され ます 。 


Not an allowed type 
ソー ス フ ァ イル の 中 で , 許さ きれ な い 型 、 た と えば 関数 を 返す 関数 、 配列 を 返す 関数 な 
ど を 宣言 し て いま す 。 


Out of memory 
使用 で きる メモ リ が な く な り ま し た 。 メ モリ を 増設 する 必要 が あり ます 。 す で に メイ 
ンズ モリ に 640KB を 実装 し て いる の で あれ ば , デバ イス ドラ イ バ を 減ら し て 利用 で き 
る メモ リ を ふやす か , プロ グラ ム を 分 割 す る な ど し て ソー ス フ ァ イル を 小さ くす る こ 
と を 考え て くだ さい 。 


Pointer required on left side of -> 
矢印 演算 子 (->) の 左側 に は ポイ ンタ し か 置け ませ ん 。 


Redeclaration of "XXXXXXXX* 
この 識 別 名 は , 以前 に 宣言 され て いま す 。 


Size of structure or array not known 
sizeof の よう な 式 が , 未定 義 の 構造 体 や 長き さ が 空 の 配列 と と も に 使わ れ ま し た 。 構 千 
体 は その 大 き さ が 必要 な けれ ば , 定義 の 前 に 参照 する こと が で きま す 。 配 列 は , メ 
モリ 領域 を 確保 する の で は な い 場 合 や 長 さ を 与え る 初期 化 子 が 後に 続く 場合 は , 長 
さ を 空 に し て 富 言 が で きま す 。 


Statement missing : 
最後 に も セミコロン が つい て いな い 文 が あり ます 。 


Structure or union syntax error 
予約 語 struct また は union の 後に , 識別 名 ある い は ("が あり ませ ん 。 


Structure size too large 
メモ リ に 入り きら な い 大 き さ の 構造 体 を 宣言 し て いま す 。 
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Subscripting missing ] 
右 カ ッ コ ]' が な い 添 字 式 が あり ます 。 こ れ は 演算 子 を 入れ なか っ た り , 余計 に 入れ て 
し まっ た り , カッ コ の 対応 が 悪い 時 に で る エラ ー で す 。 


Switch statement missing ( 
switch 文 で ,。 キー ワー ド switch の 後に 左 カ ッ コ '( が あり ませ ん 。 


Switch statement missing ) 
switch 文 で , 判定 式 の 後に 右 カ ッ コ )'" が あり ませ ん 。 


Too few paraments in call 
(関数 ポイ ンタ に よる ) プロ ト タ イ プ を 持つ 関数 へ の 呼び 出し に お いて , 引数 の 数 が 
少な すぎ ます 。 プ ロト タイ プ は , すべ て の 引数 が 渡さ れる こと を 要求 し ます 。 


Too few parameters in call to XXXXXXXX' 
(プロ ト タ イ プ で 宣言 きれ た ) 関数 の 呼び 出し に お いて , 引数 の 数 が た り ま せん 。 


Too many cases 
switch 文 の ケー ス の 数 の 上 限 は 257 で す 。 


Too many decimal points 
肖 動 小数 点 定数 中 に 小数 点 が 複数 あり まし た 。 


Too many default cases 
1 つの switch 文 の 中 に default 文 が 複数 あり まし た 。 


Too many exponents 
浮動 小数 点 定数 の 中 に 指数 部 が 複数 あり まし た 。 


Too many initializers 
宜 言 に よっ て 許さ れる 個数 以上 の 初期 化 子 が 存在 し ます 。 


Too many storage classes in declaration 
1 つの 定 言 は , 複数 個 の 記憶 クラ ス を 持つ こと は で きま せん 。 
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Too many types in declaration 
1 つの 宣言 は , 複数 個 の 型 を 持つ こと は で きま せん 。 型 は 次 の 基本 型 の いずれ か で す 。 


char, int、 float, double, struct、 union、 enum, typedef 名 


Too much auto memory in function 
現在 の 関数 は , 使用 で きる メモ リ 以 上 の 自動 記 境 領域 を 宜 言 し て いる 。 


Too much code defimed in file 
現在 の ソー ス フ ァ イル の 中 の 関数 を 合わ せ た 大 き さ が 64K バイ ト を 越え まし た 。 必要 
の な い コ ー ド を 削る か 、 ソ ー ス ファ イル を 分 割 す る か し て くだ さい 。 


Too much global data defined in file 
グロ ー バ ル な デー タ 人 宣言 の 総計 が 64K バイ ト を 越え まし た 。 大 きす ぎる 配列 が な いか 
調べ て くだ さい 。 全 部 が 必要 な 場合 は 、 プロ グラ ム の 再編 成 を 考え て くだ さい 。 


Two consecutive dots 
3 つの 連続 し た ピリ オド (..….) は 省略 を 意味 し , 1 個 の ピリ オド は 小数 点 や メン バ を 指 
定 する の に 使わ れ ま す 。 し か し 、2 つ の 連続 する ビリ オド は C で は 使わ れ ま せん 。 


Type mismatch in parameter# 
(関数 パイ ンタ に よっ て 呼び 出さ れる ) 関数 が プロ ト タ イ プ と と も に 人 定 言 され て いて 。 
左 か ら #N 番目 の 引数 は 宣言 の 引数 型 に 変換 され る こと が で きま せん で し た 。 


Type mismatch in parameter# in callto "XXXXXXXX* 
ソー ス フ ァ イル の 中 で , 関数 が プロ ト タ イ プ と と も に 合 言 され て いま す が , 左 か ら #N 
番目 の 引数 を , 宜 言 の 引数 型 に 変換 する こと が で きま せん で し た 。 


Type mismatch in parameter "XXXXXXXXY 
ソー ス フ ァ イル の 中 で , 関数 ポイ ンタ に よっ て 呼び 出さ きれ る 関数 が プロ ト タイプ と と 
も に 宣言 され て いま す が , 引数 を 宣言 の 引数 型 に 変換 する こと が で きま せん で し た 。 


Type mismatch in parameter "XXXXXXXX'in callto YYYYYYYYY 


ソー ス フ ァ イル の 中 で , 関数 が プロ ト タ イ プ と と も に 宣言 され て いま す が , 引数 を 宣 
言 の 引 数 型 に 変換 する こと が で きま せん で し た 。 
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Type mismatch in redeclaration of "XXXY 
ソー ス フ ァ イル の 中 で , ある 変数 が , も と も と 宣言 され た 型 と は 異な る 型 に 再 宣言 き 
れ て いま す 。 これ は , ある 関数 が まず 呼び 出さ れ 、 その 後 で 整数 と は 違う も の を 返す 
と 宜 言 され た 場合 に 起こ り ま す 。 こ の エラ ー が 出る 場合 は 、 その 関数 が 最初 に 呼び 出 
きれ る 前 に 、 関 数 の extern 宮 言 を 入れ ます 。 


Unable to create output file XXXXXXXX.XXXY 
この エラ ー は , 作業 用 ディ スク が いっ ぱい に な っ た り ,。 ライ ト プ ロ テク ト さ れ て いる 
場合 に 出 ま す 。 い っ ぱい の 場合 は 不 必要 な ファ イル を 削除 し ,。 コン バイ ル を や り 直 
し ます 。 ラ イト プロ テク ト さ きれ て いる 場合 は 、 そ の ソー ス フ ァ イル を 書き 込み 可能 な 
ディ スク に コピ ー し て 、 コン バイ ル を や り 直 し て くだ さい 。 


Unable to create turboc.Ink 
コン バイ ラ が テン ポラ リフ ァイル TURBO.$ LN を 作成 する こと が で きま せん 。 この 
エラ ー は 、 コン パイ ラ が ディ スク を アク セス で き な い か ,、 ディ スク が いっ ぱい の 場合 
こ 出 ます 。 


Unable to execute command "XXXXXXXX* 
TLINK また は TASM が 見 つか り ま せん 。 ま た は ディ スク が 填 れ て いま す 。 


Unable to open include file "XXXXXXXX.XXXY 
コン バイ ラ が 指定 の ファ イル を 見 つけ られ ませ ん で し た 。 こ の エラ ー は , イン クル ー 
ド フ ァイル が 自分 自身 を イン クル ー ド し て いる 場合 に も 出 ます 。 指 定 の ファ イル が 存 
在 し て いる か チェ ッ ク し て くだ さい 。 


Unable to open input file XXXXXXXX.XXX* 
この エラ ー は , ソー ス フ ァ イル が 見 つか ら な か っ た 場合 に 出 ま す 。 フ ァイル 名 の スペ 
ル と 、 その ファ イル が 指定 の ディ スク や ディ レク トリ に 存在 し て いる か どう か を チェ 
ッ グ で :《 だ さ 35 


Undefined label XXXXXXXXY 
goto 文 で 使用 まれ て いる ラベ ル の 定義 が あり ませ ん 。 


Undefined structure "XXXXXXXXY 
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構造 体 . エラ ー が 示さ れ て いる と ころ より 前 で 使用 し て いま す が , その 構造 体 に 対 
する 定義 が ありま せん 。 こ の エラ ー は , 構造 体 名 を スペ ルミ ス し た か , 宣言 を 忘れ た 
場合 に で ます 。 


Undefined symbol "XXXXXXXX" 
この 識別 名 は 宣言 さき れ て いま せん 。 こ れ は , この 行 あ る い は 宣言 を 行なっ て いる 行 で 
スペ ルミ ス を し て いる こと に よっ て 起こ り ま す 。 こ の 識別 名 の 宣言 で エラ ー が 起こ っ 
て いる 場合 に も 、 この エラ ー は で ます 。 


Unexpected end of file in comment started on lime# 
コメ ント の 途中 で , ソー ス フ ァ イル が 終わ っ て いま す 。 こ の エラ ー は , 通常 は コメ ン 
ト の 終わ り の 記号 (*/) を 忘れ た こと で 起こ り ま す 。 


Unexpected end of file in conditional started on line# 
コン パイ ラ が #endif に 出会う 前 に ソー ス の 終わ り が 現われ まし た 。#endif を 入れ 忘 
れ た か スペ ルミ ス が 原因 で す 。 


Unknown preprocessor directive : "XXX* 
行 の 初め に 文字 # が あり ます が , それ に 続く 指令 名 が 次 の いずれ で も あり ませ ん で し 
た 。 
define、 undef、line, if, ifdef, ifndef, include, else, endif 


Unterminated character constant 
対応 し て いな い 単 引用 符 が あり ます 。 


Unterminated string 
対応 し て いな い 二 重 引用 待 が あり ます 。 


Unterminated string or character constant 
文字 列 あ る い は 文字 定数 が 始ま っ て いま す が , それ を 終了 させ る 引用 符 が あり ませ ん 。 


User break 


統合 環境 で コン パイル 中 ある い は リン ク 中 に 、C7RL-S7OP (Cgk/-Break) が 入力 され 
まし た 。 
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While statement missing ( 
while 文 で , 判定 式 の 後 の 右 カ ッ コ '( が あり ませ ん 。 


While statement missing ) 
while 文 で , 判定 式 の 後 の 右 カ ッ コ "が あり ませ ん 。 


Wrong number of arguments in call of XXXXXXXXY 
マク ロ の 呼び 出し て , 引数 の 個数 が 定義 と 一 致し て いま せん 。 
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警告 


"XXXXXXXX' declared but never used 
指定 の 変数 が ソー ス フ ァ イル 中 で 宮 言 さま れ て いま す が , 全く 使わ れ て いま せん 。 こ の 
警告 は , 捜 合 文 、 つ まり 関数 の 終わ り の カッ コリ "に コン バイ ラ が 出会っ た 段階 で 出力 
され ます 。 変 数 の 宜 言 は 複合 文 、 つ まり 関数 の 初め で 始ま り ます 。 


"XXXXXXXX' is assigned a value which is never used 
変数 は 代入 文 に は 使わ れ て いま す が , その 他 で は 全く 使わ れ て いま せん 。 この 警告 は , 
コン パイ ラ が 終わ り の "カッ コ に 出会っ た 段階 で 出力 され ます 。 


"XXXXXXXX' not part of structure 
指定 の フィ ー ル ド は , ドッ ト (.) また は 矢印 (->) の 左側 に ある 構造 体 の 一 部 分 で な 
いか , ある い は 左側 に ある も の が 構造 体 で な い (ドッ ト の 場合 ) か , 構造 体 を 指す ポ 
イン タ (矢印 の 場合 ) で は な いこ と を 意味 し ます 。 


Ambiguous operators need parentheses 
この 警告 は 、2 つ の シフ ト 演 算 子 , 関係 注 算 子 。 ビッ ト 論 理 演算 子 が カッ コ な し に 連続 
し て 現われ た と き に 出力 され ます 。 ま た , 加算 ある い は 減 條 演 算 子 が カッ コ な し に シ 
フト 演算 子 と と も に 現われ た 場合 に も この 警告 が 出 ます 。 演 算 子 の 優先 順位 は 、 や や 
直感 的 に と ら え に くい 点 が あり , プロ グラ マ は よく 優先 順位 を 間違え が ち で す 。 


Both return and return of a value used 
この 警告 は 、 コ ン バ イ ラ が 関数 の 中 の 前 の return 文 と は 一 致し な い return 文 に 出 会 
っ た 段階 で 出力 され ます 。 値 を 返す return 文 と , 値 を 返さ な い return 文 が ある と い 
うこ と な の で , これ は お そら く エ ラー で す 。 


Call to function with no prototype 


この メッ セー ジ は , "Prototypes required" 警 告 が 許可 され て , プロ ト タイ プ を 最初 に 
与え ず に その 関数 を 呼び 出し た 場合 に 出力 され ます 。 
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Call to function "XXXX' with no prototype 
この メッ セー ジ は , "Prototypes required" 警 告 が 許可 され て いて , プ ロト タイ プ を 最 
初 に 与え を ず に 関数 XXXX を 呼び 出し た 場合 に 出力 され ます 。 


Code has no effect 
この 警告 は 。 コン パイ ラ が , 何 の 効果 も な い 演 算 子 を 含む 文 が あっ た と き に 出力 され 
ます 。 た と えば 次 の 文 は 。 


どちら の 変数 に 対し て も 何 も 影響 を 与え を ませ ん 。 こ うし た も の は 不要 で あり 、 な ん ら 
か の バグ を 意味 し て いる こと も あり ます 。 


Constant is long 
コン バイ ラ が , 32767 よ り 大 きい 10 進 定数 , ある い は 65535 よ り 大 きい 8 進 ( ま た は 16 進 ) 
定数 で 最初 に 1 や し の 文字 が つい て いな いも の が あっ た 場合 に 出力 され ます 。 こ れ ら 
の 定数 は long と し て 扱わ れ ま す 。 


Constant out of range in comparison 

ソー ス フ ァ イル 中 に , あ る 定数 部 分 式 が も う 1 方 の 部 分 式 の 型 に よっ て 許さ れる 範囲 の 
外側 に ある 場合 の 比較 が 含ま れ て いま す 。 た と えば unsigned の 値 を -1 と 比較 する よ 
う な 場合 で す 。32767 (10 進 ) より 大 きい unsigned 型 に キャ スト する (た と えば (un- 
signed) 65535) か , 定数 の 最後 に u ま た は U を つけ ます (た と えば 65535u) 。 

この メッ セー ジ が 出力 され て も , コン バイ ラ は 比較 の た め の コ ー ド を 生成 し ます 。 こ 
の コー ド が 常に 同じ 結果 を 与え る も の (文字 式 を 4000 と 比較 する と いっ た も の ) で あ 
っ て も , 必 ら ず 判 定 は 行なわ れ ま す 。 これ に より unsigned 型 の 式 と -1 を 比較 し て も 意 
味 が ある と いう こと に な り ま す 。 実際 (unsigned) 65535 と -1 は , 8086 上 で は 同じ ビッ 
トバ パタ ー ン を 与え る か ら で す 。 
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Conversion may lose significant digits 
代入 文 を ど に お いて , long ある い は unsigned long か ら , int ある い は unsigned int 
へ の 変換 が 行なわ れる 場合 が あり ます 。 マ シン に よっ て は , int と long の 変数 が 占め 
る バイ ト 数 が 同じ 場合 も ある の で , この 種 の 変換 が プロ グラ ム の 動作 を 変え て し まう 
こと が あり ます 。 
この メッ セー ジ を 出力 し た 場合 に は ,、 コン バイ ラ は 比較 を 行なう コー ド を 生成 し ます 。 
char 型 の 式 を 4000 と 比較 する よう な 場合 に 、 生成 し た コー ド が 常に 同じ 結果 を 示す と 
し て も , この コー ド は や は り 比 較 を 行ない ます 。 こ れ は 、unsigned の 式 と -1 と の 比較 
で も 有効 な 場合 が ある こと を 意味 し ます 。8086 に お いて は , unsigned の 値 が 。-1 と 同 
ヒビ ッ ト パ ターン を と る こと も あり 得る か ら で す 。 


Function should return a value 
この 関数 は int 型 や void 型 以外 の 型 の 値 を 返す と 宣言 され て いる の に . 値 を 返さ な い 
return 文 が 使わ れ て いま す 。 おそらくは エラ ー で す 。 古い タイ プ の C で は , 値 を 返 き 
な い 関 数 で ある こと を 意味 する void 型 が な か っ た の で 。 int 型 と 宣言 され て いる 場合 
は この メッ セー ジ は 出 ま せん 。 


Hexadecimal or octal constant too large 
文字 列 リ テラ ル あ る い は 文字 定数 に お いて , 255 を 越え る 値 (た と そば ぎ 777 や 壮 x1234) 
を 持つ 16 進 また は 8 進 エ スケ ー プ シー ケン ス が 指定 され て いま す 。 


Mixing pointers to signed and unsigned char 
char ポイ ン 夕 か ら unsigned char ポイ ンタ へ の 変換 (ある い は その 逆 ) を , キャ スト 
な し で 行なっ て いま す ( 央 密 に いう と これ は 間違い で す が , 8086 で は あま り 問 題 に な 
り ま せん )。 


No declaration for function "XXXXXXXX" 
これ は , この 警告 が オン に な っ て いて (-wnod)、 関 数 を 宣言 せ すず に 呼び 出し て いる 場 
合 に 出力 され ます 。 宣 言 は 古典 ・ モ ダン (プロトタイプ ), いずれ の スタ イル で も か ま 
W' ま 志ん 。 


Non-portable pointer aSSignment 
ポイ ンタ を ポイ ンタ で な いも の へ 代入 (ある い は その 逆 ) し て いま す 。 ポ イン タ に 0 を 
代入 する こと は , 特別 を 場合 と し て 許さ れ て いま す 。 こ の 警告 を 出さ な いよ うに キャ 
スト すべ き で す 。 
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Non-portable pointer comparison 
ポイ ンタ を 0 以外 の ポイ ンタ で な い 値 と 比較 し て いま す 。 比較 が 適切 な 場合 , この 警告 
を 出 き な いよ う キ ャ スト すべ き で す 。 


Non-portable return type conversion 
return 文 の 中 の 式 の 型 が , 関数 宣言 の 型 と 同じ で は あり ませ ん 。 関 数 また は 戻り 値 が 
ポイ ンタ の 場合 に この エラ ー が で ます 。 唯一 の 例外 は , ポイ ンタ を 返す 関数 が 定数 0 を 
返す 場合 で す 。0 は 適当 を ポイ ンタ 値 に 変換 され ます 。 


Parameter "XXXXXXXX' is never used 
関数 の 中 で 宣言 され た 引数 が , 関数 本 体 の 中 で 使用 きれ て いま せん 。 エ ラー か どう か 
は 確定 で きま せん が , 引数 の スペ ルミ ス に よっ て よく 起こ り ま す 。 ま た 関数 の 本 体 で 
自動 (ロー カル ) 変数 と し て 再 宣 言 さ れ て いる 場合 も あり ます 。 こ の 場合 引数 が 自 
動 変 数 に よっ て マス ク さ れ , 未 使用 の まま に な り ま す 。 


Possible use of XXXXXXXX' before definision 
変数 に 値 が 代入 され る 前 に , その 変数 が 式 の 中 で 使わ れ て いま す 。 こ の 点 に 関し て コ 
ン パ イラ が 行なう 検査 は 簡単 な も の で , 変数 の 使用 が 代入 より も ソー スコ ー ド 中 で 物 
理 的 に 前 に ある と , この 警告 が 出 ま す 。 実 際 の プロ グラ ム の 流れ で は , 使用 する 前 に 
代入 され る の か も し れ ま せん 。 


Possibly incorrect assignment 
この 警告 は , if 文 , while 文 , do-while 文 な ど で , 条件 式 の 主たる 演算 子 が 代入 演算 子 
で あっ た 場合 に 出力 され ます 。 ニ 演算 子 と まち が えて , を 使っ て いる 場合 に よく 起 
こる も の で す 。 こ の 警告 を 抑制 する に は , 代入 文 を カッ コ で 囲み 、 その 全体 と し て の 
値 と ゼロ と の 比較 を 明示 的 に 行なっ て くだ さい 。 た と えば 次 の 式 を , 


iE (ea = も b) 


次 の よう に 書き 変え ます 。 


IE ((a = b) != 0) …・ 


Redefinition of "XXXXXXXX' is not identical 
前 に 定義 8 れ て いる マク ロ を , 別 の テキ スト で 再 定義 し て いま す 。 こ の 場合 マク ロ は 
新しい テキ スト で 置き 換え られ ます 。 
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Restarting compile using assembly 
-B コン パイ ラオ プシ ョ ン , ある い は #pragma inline 文 の 指定 な し で , asm 文 に 出 会 
いま し た 。 ア セン プリ 言語 機能 を 使用 し て , コン パイ ル を リス ター ト し ます 。 


Structure passed by value 
この 警告 を オン に し て いる 場合 (-wstv), 構造 体 が 引数 と し て 値 で 渡さ れ て いる と , 
この 警告 が で ます 。 よ く あ る の は , 引数 と し て 構造 体 の アド レス を 渡す べき と ころ 
で , & 演 算 子 を つけ 忘れ る こと で す 。 構 造 体 は 値 で 渡す こと も で きる の で エラ ー と は な 
り ま せん 。 この 警告 は プログ ラム ミス を 気づか せる た め の も の で す 。 


Superfluous & with function or array 
アド レス of 演算 子 (&) は 配列 名 や 関数 名 に つけ る 必要 は あり ませ ん 。 こ の 場合 & 演 
算 子 は 削除 され ます 。 


Suspicious pointer conversion 
異な る 型 を 指す ポイ ンタ の 間 で 変換 を 行なっ て いま す 。 そ の 変換 が 適切 な も の で ある 
な ら ば , この 警告 を 出 き な いよ うに する た め に は キャ スト を 使用 し て くだ さい 。 


Undefined structure "XXXXXXXX" 
ソー ス フ ァ イル の 中 で 使用 され て いる 構造 体 XXXXXXXX は , 定義 され て いま せん 。 
これ は , 構造 体 名 の スペ ルミ ス , ある い は 宣言 が な いこ と に よっ て 起こ り ま す 。 


Unknown assembler instruction 
イン ライ ン ア セン プリ 文 に 許さ れ な い 命令 コー ド が 使わ れ て いま す 。 命 令 コ ー ド を チ 
ェ ッ ク し て くだ さい 。 命令 が 受け 入れ られ る も の か どう か , 許さ れ て いる 命令 コー ド 
の 一 覧 表 も チェ ッ ク し て くだ さい (ユー ザー ズ ガ イド 第 12 章 ) 。 


Unreachable code 
break, continue、 goto, return の 後に 、 ラ ベル ,、 あ る い は ルー プ や 関数 の 終わ り が 
続い て いま せん 。 コ ン バ イ ラ は , 条件 判定 式 が 定数 の while、do,for ルー プ を チェ ッ 
クレ し , 無限 ルー プ を 認識 し よう と し ます 。 


Void functions may not return a value 


この 関数 は void 型 と 宣言 され て いる の に 値 を 返 と そう と する return 文 が あり ます 。 
return 文 の 値 は 無視 され ます 。 
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Zero length structure 
大 きき が ゼロ の 構造 体 が 宜 言 さ れ て いま す 。 こ の 構造 体 を 使用 する と エラ ー に な り ま 


す 。 
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ここ で は , TurboC に お ける 構文 の 要約 を 行ない ます が 、 BNF (バッ カス - ナ ウ ア 記法 ) 
を 少し 修正 し た も の を 使用 する こと に し ます 。 交 の よう に 3 つの カテ ゴリ に わけ て 説明 を 行 
な いま す 。 
一 語 意 に 関す る 文法 トー クン , キー ワー ド 、 識 別名 、 定 数 、 文字 列 リ テラ ル , 演算 子 , 
区 切子 
田 フ レー ズ の 構文 に 関す る 方 法 : 式 , 宣言 , 文 , 外部 定義 
田 プ リプ ロ セ ッ サ 指令 


構文 中 の オプ ショ ン (省略 可能 ) の 要素 は , 不 等 号 記号 (<...>) で 囲ん で あり ます 。 
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語 意 に 関す る 文法 


キー ワー ド (予約 語 ) 


キー ワー ド : 以下 の うち の 1 つ 


asm 
auto 
break 
CaS@e 
cdec1 
char 
const 
continue 


defaut 
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do 
double 
else 
enum 
extern 
far 
float 


for 


int 
interrupt 
long 

near 
pascal 


register 


return 
short 
signed 
sizeof 
static 
Struct 
switch 


typedef 
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union 
unsigned 
void 
volatile 
while 
=C8: 

_ds 

_es 


_ss 
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識別 名 


識別 名 : 
非 数 字 
識別 名 非 数 字 
識別 名 数 字 


非 数 字 : 以下 の うち の 1 つ 
abcdefghijklmnopqrstuvwxyz 


ABCDEFGHIJKLMNOPQRSTUVWXYZ 


数 字 : 以下 の うち の 1 つ 
0 1 2 3 4 5 6 7 8 9 


定数 


定数 : 
浮動 小数 点 小数 
整定 数 
列 拳 型 定数 
文字 定数 


浮動 小数 点 定数 : 
小数 点 定数 < 指数 部 > < 浮動 小数 点 接尾 辞 > 
数 字 の 並び 指数 部 < 浮動 小数 点 接尾 辞 > 


小数 点 定数 : 


く 数字 の 並び >. 数 字 の 並び 
数 字 の 並び . 
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指数 部 : 
e < 符号 > 数 字 の 並び 
E < 符号 > 数 字 の 並び 


浮動 小数 点 接尾 矢 
負 。 


数 字 の 並び : 
数 字 
数 字 の 並び 数 字 


浮動 小数 点 接尾 辞 : 以下 の うち の 1 つ 
才 - 和 戸 。 所 


整定 数 : 
10 進 定数 く 整 数 接尾 辞 > 
8 進 定数 < 整数 接尾 辞 > 
16 進 定数 < 整数 接尾 辞 > 


10 進 定数 : 
非 ゼ ロ 数 字 
10 進 定数 数 字 


8 進 定数 : 
0 
8 進 定数 8 進数 字 


16 進 定数 : 
0x16 進 数 字 
0X16 進 数 字 
16 進 定数 16 進 数 字 


非 ゼ ロ 数 字 : 以下 の うち の 1 つ 
1 2 3 4 5 5 
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8 進数 字 : 以下 の うち の 1 つ 
WW 衝 2 窓 光 - ま 。 泡 呈 


16 進 数 字 : 以下 の うち の 1 つ 
中 肖 4 


m 
の 
ー 
に コ 
ら 


整数 接尾 辞 : 
符号 な し 接尾 辞 く 倍 長 接 尾 辞 > 
倍 長 接尾 辞 < 符号 な し 接尾 辞 > 


符号 な し 接尾 辞 : 以下 の うち の 1 つ 
u U 


倍 長 接尾 辞 : 以下 の うち の 1 つ 
中 


列挙 型 定数 : 
識別 子 


文字 定数 : 
て 文字 の 並び 


c 文字 の 並び : 
< 文字 
c 文字 の 並び < 文字 
し か" 
ソー ス 記 述 文字 セッ ト の 文字 な ら ど ん な 文字 で も 。 た だ し , 単 引用 符 (, 円 記号 


( 光 )。 改 行文 字 を 除く 。 


エス ケー プシ ー ケ ンス 


語 意 に 関す る 文法 ZZ の 


エス ケー プシ ー ケ ンス : 以下 の うち の 1 つ 


ャ r 
\" 
\? 
Yy\ 
\a 


文字 列 リ テラ ル 


\b 
\f 
\n 
\r 
\t 


\v 
\o 
\oo 
\ooo 
\xh 


\xhh 
\xhhh 
\Xh 
\Xhh 
\Xhhh 


文字 列 リ テラ ル : 
"<s 文字 の 並び >" 


ゞ 文字 の 並び : 
ゞ 文字 
ゞ 文字 の 並び 文字 


文字 : 


ソー ス 記 述 文字 セッ ト の 文字 な ら ど ん な 文字 で も 。 ただし, 二 重 引用 符 (")、 円 記号 
( ま ), 改行 文字 を 除き ます 。 


エス ケー プシ ー ケ ンス 
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演算 子 


演算 子 : 以下 の うち の 1 つ 


ロ 0 2 + 二 ー 
に 1 ポ キ ー と 1 
sizeof / % くく >> < く 
> く <= >= ニニ 1 三 
| && 1 し 

ネー /= %= ニー ーー < く = 
>> ニ & ニ 幅 ニ # 
胡 

区 切子 

区 切子 : 以下 の うち の 1 つ 
[ 0 せ * 1 
円 2 # 
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フレ ー ズ の 構造 に 関す る 文法 


式 


一 次 式 : 
識別 子 
定数 
疑似 変数 
文字 列 リ テラ ル 
( 式 ) 


疑似 変数 
_AX 。 AL AH SIl ES 
_BX BL  BH DI ss 
_CX  CL  cH  BP CS 
_DX DL pH SsP ps 


ポス ト フ ィ ッ クス 式 : 
一 次 式 
ポス ト フ ィ ッ クス 式 [ 式 ] 
ポス ト フ ィ ッ クス 式 (< 引数 式 リ スト >) 
ボス ト フ ィ ッ クス 式 . 識別 子 
ポス ト フ ィ ッ クス 式 -> 識別 子 
ボス ト フ ィ ッ クス 式 十 二 
ポス ト フ ィ ッ クス 式 一 


引数 式 リ スト : 


代入 式 
引数 式 リ スト , 代入 式 
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単項 式 : 
ポスト フィ ックス 式 
十二単 項 式 
一 単項 式 
単項 演算 子 キャ スト 式 
sizeof 単項 式 
sizeof ( 型 名 ) 


単項 演算 子 : 以下 の うち の 1 つ 


を  * ー キ ーー ーー 


キャ スト 式 : 
単行 式 
( 型 名 ) キャ スト 式 


乗法 式 : 
キャ スト 式 
乗法 式 * キャ スト 式 
乗法 式 / キャ スト 式 
乗法 式 % キャ スト 式 


加法 式 : 
乗法 式 
加法 式 十 乗法 式 
加法 式 - 乗法 式 


シフ ト 式 : 
加法 式 
シフ ト 式 < 加法 式 
シフ ト 式 >> 加法 式 


関係 式 : 
シフ ト 式 
関係 式 < シフ ト 式 
関係 式 > シフ ト 式 
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関係 式 <= シフ ト 式 
関係 式 > ニ シフ ト 式 


等 号 式 ニ = 関係 式 
等 号 式 ! 三 シフ ト 式 


AND 式 : 
等 号 式 
AND 式 & 等 号 式 


排他 的 OR 式 : 
AND 式 
排他 的 OR 式 ′ AND 式 


OR 式 : 
排他 的 OR 式 
OR 式 排他 的 OR 式 


論理 AND 式 : 
OR 式 
論理 AND 式 && OR 式 


論理 OR 式 : 
論理 AND 式 
論理 OR 式 論理 AND 式 


条件 式 : 
論理 OR 式 
論理 OR 式 ? 式 : 条件 式 


代入 式 : 


条件 式 
単行 式 代入 演算 子 代入 式 
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代入 演算 子 : 以下 の うち の 1 つ 


十 
I 


宣言 : 


宣言 指定 子 < 初期 値 宣 言 リス ト > 
宣言 指定 子 : 
記憶 クラ ス 指定 子 < 宣言 指定 子 > 
型 指定 子 く 宣 言 指 定子 > 
初期 値 宣言 リス ト : 
初期 値 宣言 
初期 値 宣言 リス ト , 初期 値 宣 言 子 


初期 値 宣言 子 : 
宣言 子 
宣言 子 


初期 化 子 
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記憶 クラ ス 指定 子 : 
typedef 
extern 
static 
auto 


register 


型 指定 子 : 
void 
char 
short 
int 
long 
float 
double 
signed 
unsigned 
const 
volatile 
構造 体 ・ 共 用 体 指 定子 
列 拳 型 指定 子 
typedef 名 


構造 体 ・ 共 用 体 指定 子 : 
構造 体 ・ 共 用 体 < 識別 名 〉 { 構造 体 宣言 リス ト } 
構造 体 ・ 共 用 体 識別 名 


構造 体 ・ 共 用 体 : 
Struct 


union 
構造 体 宣 言 リス ト : 


構造 体 宣 言 
構造 体 宣 言 リス ト 構造 体 宣 言 
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構造 体 宣言 : 


型 指定 子 リス ト 構造 体 宣言 チ リス ト : 


型 指 定 チ リス ト : 
型 指定 子 
型 指定 子 リ スト , 型 指定 子 


構造 体 宣言 リス ト : 
構造 体 宣 言 子 
構造 体 宣 言 子 リス ト , 構造 体 宣 言 子 


構造 体 宣言 子 : 
宣言 子 
< 宣言 子 > : 定数 式 


列 拳 型 指定 子 : 
enum く 識 別名 > { 列挙 子 リス ト } 
enum 識別 名 


列 拳 子 リ スト : 
列挙 子 
列 拳 子 リス ト , 列挙 子 


列 拳 子 : 
列 拳 型 定数 
列挙 型 定数 = 定数 式 


宣言 子 : 


く 〈 ボ イン タ > 直接 宣言 子 
〈 修 飾 子 リス ト > 
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直接 宣言 子 : 
識別 名 
( 宣言 子 ) 
直接 宣言 子 [< 定数 式 >] 
直接 宣言 子 ( パラ メー タ 型 リス ト ) 
直接 宣言 子 (< 識別 名 リス ト 〉) 


ポイ ンタ : 
* < 型 指定 子 リス ト > 
* < 型 指定 子 リ スト > ポイ ンタ 


修飾 リ スト : 
修飾 子 
修飾 子 リス ト 修飾 子 


修飾 子 : 
cdec 
pascal 
interrupt 
near 
far 


huge 


パラ メー タ 型 リス ト : 
パラ メー タリ スト 
パラ メー タリ スト ,.… 


引数 リス ト : 
引数 宣言 
引数 リス ト , 引数 宣言 


パラ メー タ 宣 言 : 


宣言 指定 子 宣言 子 
宣言 指定 子 < 抽象 宣言 子 > 
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識別 名 リス ト : 
識別 名 
識別 名 リス ト , 識別 名 


型 名 : 
型 指 定 リス ト < 抽象 宣言 子 > 


抽象 宣言 子 : 
ボイン タ 
〈 く ポイ ンタ > < 直接 抽象 宣言 子 > 
〈 修 飾 子 リ スト > 


直接 抽象 宣言 子 : 
( 抽象 宣言 子 ) 
く 直接 抽象 宣言 子 > [< 定数 式 >] 
< 直接 抽象 宣言 子 > (< バラ メー タ 型 リス ト >) 


typedef 名 : 
識別 名 


初期 化 子 : 
代入 式 
{ 初期 化 子 リス ト } 
{ 初期 化 子 リス ト ,} 


初期 化 子 リス ト : 


初期 化 子 
初期 化 チ リスト, 初期 化 子 
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ラベ ル つ き 文 
複合 文 

式 文 

選択 文 

繰り 返し 文 
飛び 越し 文 


asm 文 


asm 文 : 
asm トー クン 改行 
asm トー クン : 


ラベ ル つ き 文 : 
識別 名 : 文 
case 定数 式 : 文 
defaut : 文 


複合 文 : 
人 宣言 リス ト > < 文 リ スト >〉} 


宣言 リス ト : 
宣言 
宣言 リス ト 宣言 


文 リス ト : 
文 
文 リス ト 文 


式 文 : 
< 式 > : 
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選択 文 
if( 式 ) 文 
if( 式 ) 文 else 文 
switch ( 式 ) 文 


繰り 返し 文 : 
while( 式 ) 文 
do 文 while( 式 ): 
for (< 式 >: < 式 >: < 式 >) 文 


飛び 越し 文 : 
goto 識別 名 : 
continue i 
break : 
return < 式 > : 


外部 定義 


ファ イル : 
外部 定義 
ファ イル 外部 定義 


外部 定義 : 
関数 定義 
宣言 


関数 定義 : 
く 宣言 指定 子 > 宣言 子 < 宣言 リス ト > 複合 文 


プリ プロ セッ サ 指 令 Z91 


プリ プロ セッ サザ 指令 


プリ プロ セッ シン グフ ァイル : 
グル ー プ 


グル ー プ : 
グル ー プ 部 
グル ー プ グル ー プ 部 


グル ー プ 部 : 
< の トー クン > 改行 
が セク ショ ン 
制御 行 


が セク ショ ン : 
が ザ グループ <e/ グル ー プ 群 > <e/se グル ー プ > ezg/7 行 


が グル ー プ : 
# が 7 定数 式 改行 く グ ルー プ > 
#/ が 2e/ 識別 名 改行 < グル ー プ > 
#7de/ 識別 名 改行 く < グル ー プ > 


e/7 グル ー プ 群 : 
e77 グル ー プ 
e/7 グル ー プ 群 e が が グルー プ 


e が 7 グル ー プ : 
#elif 定数 式 改行 く < グル ー プ > 


ese グル ー プ : 
#else 改行 < グル ー プ > 
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ez の 7 行 : 


#endif 改行 

制御 行 
#include 。 PP トー クン 改行 
#define 識別 名 置換 リス ト 改行 
#define 識別 名 左 カ ッ コ < 識別 名 リス ト > ) 置換 リス ト 
#undef 識別 名 改行 
#line め トー クン 改行 
#error < の p トー クン > 改行 
#pragma < の の p ト ー ク ン > 改行 
#pragma warn アク ショ ン 短縮 語 改行 
# pragma inline 改行 
# 改行 

アク ショ ン 
+ 

短縮 語 
amb def rch stu 
amp dup ret stv 
apt eff Tng SuS 
aus mod rpt ucp 
big par ru use 
cIn pia Sig Voi 
cpt pro str ZSt 

友 カ ッ コ : 


前 に ホワ イト スペ ー ス が つい て いな い 左 カッ コ 


置換 リス ト : 


く <pp トー クン 群 > 


プリ プロ セッ サ 指 令 


改行 
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の トー クン 左 : 
プリ プロ セッ シン グ ト ー ク ン 
トー クン 群 プリ プロ セッ シン グ ト ー ク ン 


プリ プロ セッ シン グ ト ー ク ン : 
ヘッ ダ 名  (#include 指令 に お いて の み ) 
識別 名 (キー ワー ド と 重複 し な いも の ) 
定数 
文字 列 リ テラ ル 
演算 子 
区 切子 
各々 は 前 に ホワ イト スペ ー ス が つい て いな いも の 


ヘッ ダ 名 : 
<4 文字 の 並び > 


ヵ 文 字 の 並び : 
4 文字 
文字 の 並び 文字 


ム 文 字 : 
ソー ス 記 述 文字 セッ ト 中 の すべ て の 文字 。 た だ し , 改行 文字 と 不 等 号 (>) は 除く 。 
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getmodename( 関 数 ) 548 
getmoderange( 関 数 ) 549 
getpalette( 関 数 ) 550 
getpalettesize (関数 ) 551 
getpass( 関 数 ) 203 
getpixel (関数) 552 
getpsp( 関 数 ) 204 

gets( 関 数 ) 205 
gettext( 関 数 ) 469 
gettextinfo (関数) 472 
gettextsettings( 関 数 ) 553 
gettime( 関 数 ) 206 
getvect( 関 数 ) 207 
getverify( 関 数) 209 
getviewsettings (関数) 555 
getw( 関 数 ) 210 

getx( 関 数 ) 556 

gety( 関 数 ) 557 

GMT 38.180.446 
gmtime( 関 数 ) 211 


goto( ノ ン ロ ー カ ルー) 106.257.364 


gotoxy (関数) 474 
graphdefaults( 関 数 ) 558 
grapherrormsg (関数 ) 559 
graphics.h 11 
graphresult( 関 数 ) 563 


【H】 


hantozen( 関 数 ) 712 
harderr( 関 数 ) 213 
hardresume( 関 数 ) 216 


索引 


hardretn( 関 数 ) 217 
highvideo( 関 数) 475 
hypot( 関 数 ) 218 


【I】 


imagesize( 関 数 ) 565 
initgraph( 関 数 ) 566 
inport (関数 ) 219 
inportb( 関 数 ) 220 
insline( 関 数 ) 476 
installuserdriver( 関 数 ) 572 
installuserfont (関数 ) 575 
int86( 関 数 ) 221 
int86x( 関 数 ) 223 
intdos( 関 数 ) 224 
intdosx( 関 数 ) 226 
intr( 関 数 ) 228 
1/O 

画面 一 94.318 


グラ フィ ックス ー 594.622 

コン ソー ルー 103.155.156 

スト リー ム 137.142 .158 162.164.166, 
167.173.182.185.188.205.210.305, 
317.320.321.322.342.357.369.401. 
402.404,457,458,459.460,461 


ディ スク ー 637.675 


ファ イル ー 141.,146 .162.164.166.167. 
173,182,185,210.332,333.369, 


457,458.463 


ー ポ ボー ト 629.672.219.220.294 
文字 列 75.94.145.166.203.295.296, 


321.395.398.461 
ioctl (関数) 230 
io.h 11 
isalkana (関数 ) 713 


索引 


isalnmkana (関数 ) 713 
isalnum (関数 ) 232 
isalpha( 関 数 ) 233 
isascii( 関 数 ) 234 
isatty( 関 数 ) 235 
iscntrl( 関 数 ) 236 
isdigit (関数 ) 237 
isgraph( 関 数 ) 238 
isgrkana (関数 ) 714 
iskana( 関 数) 714 
iskanji2 (関数 ) 715 
iskanji( 関 数 ) 715 
iskmoji( 関 数 ) 716 
iskpun (関数 ) 716 
islower( 関 数 ) 239 
ispnkana (関数 ) 717 
isprint( 関 数 ) 240 
isprkana( 関 数 ) 717 
ispunct( 関 数 ) 241 
isspace( 関 数 ) 242 
isupper( 関 数) 243 
isxdigit (関数 ) 244 
itoa( 関 数 ) 245 


【J】 


jasctime (関数 ) 718 
jctime (関数 ) 719 
jisalpha (関数 ) 720 
jisdigit (関数 ) 720 
jishira (関数 ) 721 
jiskana (関数) 722 
jiskata( 関 数) 723 
jiskigou( 関 数 ) 724 
jis10 (関数 ) 724 
jisl1 (関数 ) 725 
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jisl2 (関数 ) 726 
jislower( 関 数) 727 
jisspace( 関 数 ) 727 
jistojms( 関 数 ) 728 
jisupper (関数) 729 
jiSzen (関数 ) 729 
JIS コー ド を 

シフ ト JIS コー ド に 変換 する 728 
JIS 第 1 水準 漢字 を 判定 する 725 
JIS 第 2 水準 漢字 を 判定 する 726 
jmstojis( 関 数 ) 730 
jstradv( 関 数 ) 731 
jstrchr (関数 ) 732 
jstrcmp( 関 数 ) 733 
jstrlen( 関 数 ) 734 
jstrmatch (関数) 735 
jstrncat( 関 数 ) 736 
jstrncmp( 関 数 ) 737 
jstrncpy (関数 ) 738 
jstrrchr (関数 ) 739 
jstrrev( 関 数 ) 740 
jstrskip( 関 数 ) 741 
jstrstr( 関 数 ) 742 
jstrtok( 関 数 ) 742 
jtohira( 関 数 ) 743 
jtokana (関数 ) 744 
jtokata( 関 数 ) 745 
jtolower( 関 数 ) 746 
jtoupper( 関 数) 747 


【K】 


kbhit (関数 ) 246 
keep (関数 ) 247 
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【L】 


labs( 関 数 ) 248 
ldexp( 関 数 ) 249 
ldiv (関数 ) 250 
lfind( 関 数) 251 
limits.h 11 
linerel( 関 数 ) 577 
lineto (関数 ) 578 
line( 関 数 ) 576 
localtime( 関 数 ) 252 
lock( 関 数 ) 254 
1og10( 関 数 ) 256 
log( 関 数 ) 255 

long int の 変換 265,448 
longmp (関数) 257 
lowvideo( 関 数 ) 477 
lsearch (関数 ) 261 
lseek (関数 ) 263 
ltoa (関数) 265 


【M】 


main( 関 数 ) 21 
C 型 と 宣言 する 25 
Pascal 呼び 出し 慣例 で の コン パイル 
25 
コマ ンド ライ ン 引 数 24 
ワイ ルド カー ド の 展開 24 
ー の 戻り 値 25 
ー へ 渡す 引数 21 
ー の 合 言 22 
例 22.23 
malloc( 関 数 ) 266 
matherr( 関 数 ) 270 
math.h 12 


索引 


max( 関 数 ) 273 normvideo (関数) 479 


mc block( 関 数 ) 691 nosound( 関 数 ) 288 
mc _continue( 関 数 ) 694 nthctype( 関 数 ) 749 
mc_ ground (関数 ) 695 
mc initialize( 関 ) 696 【0】 
mc inquire( 関 数 ) 697 open( 関 数 ) 291 
mc mode( 関 数 ) 699 outport( 関 数 ) 294 
mc_play( 関 数 ) 700 outportb (関数) 295 
mc register( 関 数 ) 702 outtext( 関 数 ) 581 
mc_rom( 関 数 ) 704 outtextxy( 関 数 ) 582 
mc_scalar( 関 数 ) 705 
mc _stop( 関 数 ) 707 【P】 
memccpy( 関 数 ) 274 parsfnm (関数) 296 
memchr (関数 ) 275 Pascal の 呼び 出し 尼 例 で 
memcmp (関数 ) 276 main を コン バイル する 25 
memcpy (関数 ) 277 PATH 環境 変数 120.389 
mem.h 12 PC の スピ ー カ 288,389 
memicmp (関数 ) 278 peekb( 関 数 ) 298 
memmove( 関 数 ) 279 peek( 関 数 ) 297 
memset (関数 ) 280 perror( 関 数 ) 30.299 
min (関数) 281 pieslice( 関 数 ) 583 
mkdir( 関 数 ) 282 pokeb (関数 ) 301 
MK _FP( 関 数 ) 283 poke( 関 数 ) 300 
mktemp( 関 数 ) 284 poly (関数) 302 
MML 689 pow10( 関 数 ) 304 
modf (関数 ) 285 pow( 関 数 ) 303 
movedata (関数 ) 286 printf( 関 数 ) 305 
moverel (関数 ) 579 process.h 12 
movetext( 関 数 ) 478 PSP 36.204 
moveto( 関 数 ) 580 putchar( 関 数 ) 319 
movmem( 関 数 ) 287 putch(functioln) 318 
mtob( 関 数 ) 748 putc( 関 数 ) 317 

【N】 putenv (関数 ) 320 

putimage (関数) 585 

NMI 割り 込み 110 putpixel( 関 数 ) 587 


索引 805 


puts( 関 数 ) 312 
puttext( 関 数 ) 480 
putuserfont( 関 数 ) 670 
putw( 関 数 ) 322 


【Q】 


qsort( 関 数 ) 323 
【R】 


raise( 関 数 ) 325 
RAM 

常駐 プロ グラ ム 247 

ー の サイ ズ を 返す 683 

未 使用 の この 量 を 返す 89 
randbrd( 関 数 ) 328 
randbwr( 関 数 ) 329 
random( 関 数 ) 330 
randomize( 関 数 ) 331 
rand( 関 数 ) 327 
read( 関 数 ) 333 
realloc( 関 数 ) 334 
rectangle( 関 数 ) 588 
registerbgidriver( 関 数 ) 589 
registerbgifont (関数 ) 591 
REGPACK 構造 体 228 
remove( 関 数 ) 335 
rename( 関 数 ) 336 
restorecrtmode (関数 ) 592 
rewind( 関 数 ) 337 
rmdir( 関 数 ) 338 
ROM の フォ ント パタ ー ン の 読み 出し 667 
RS-232C の 制御 629,634 
RS-232C コ ミュ ニケ ーション 672 
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【S】 


sbrk( 関 数 ) 341 

scanf( 関 数 ) 342 
searchpath( 関 数 ) 353 
sector( 関 数 ) 593 
segread( 関 数 ) 593 
setactivepage (関数 ) 594 
setallpalette( 関 数 ) 595 
setaspectratio( 関 数 ) 597 
setbkcolor( 関 数 ) 598 
setblock( 関 数 ) 356 
setbuf( 関 数) 357 
setcbrk( 関 数 ) 359 
setcolor( 関 数 ) 600 
setdate( 関 数 ) 360 
setdisk (関数 ) 361 
setdta (関数 ) 362 
setfillpattern( 関 数 ) 602 
setfillstyle (関数 ) 603 
setftime (関数 ) 363 
setgraphbufsize( 関 数 ) 605 
setgraphmode( 関 数 ) 607 
setimp (関数 ) 364 
setimp.h 12 
setlinestyle( 関 数 ) 608 
setmem( 関 数 ) 366 
setmode( 関 数 ) 367 
setnewdriver( 関 数 ) 610 
setpalette (関数 ) 611 
settextjustify (関数 ) 617 
settextsyle( 関 数 ) 617 
settime (関数 ) 368 
setusercharsize( 関 数 ) 620 
setybut (関数 ) 369 


索引 


setvect( 関 数 ) 372 
setverify (関数 ) 373 
setviewport (関数 ) 622 
setvisualpage( 関 数 ) 623 
setwritemode( 関 数 ) 624 
share.h 12 

signal.h 12 

signal( 関 数 ) 374 

sin (関数 ) 381 

sinh( 関 数 ) 382 

sleep( 関 数 ) 383 

sopen( 関 数 ) 384 
sound( 関 数 ) 389.387 
spawn.…( 関 数 ) 390 
sprintf (関数 ) 395 

sqrt( 関 数 ) 396 
srand( 関 数 ) 397 
sscanf( 関 数 ) 398 

stat( 関 数 ) 399 

stat 構造 体 177.399 
stdargs.h 12 

stdaux 135 

stddef.h 12 

stderr 12.135,141 

stdin 12.135,143.170.205,342.460 
stdio.h 12 

stdlib.h 12 

stdout 12.135.165.170.305.319.321.459 
stdprn 12.135 

stime( 関 数 ) 402 
stpcpy( 関 数 ) 403 
strcat( 関 数 ) 402 
strcmp( 関 数 ) 407 
strcmpi (関数 ) 406 
strcpy (関数) 407 


案 引 


strcspn( 関 数 ) 408 
strdup( 関 数 ) 409 
strerror( 関 数 ) 411 
stricmp( 関 数 ) 415 
string.h 12 

strlen( 関 数 413 
strlwr( 関 数 ) 413 
strncat( 関 数 ) 414 
strncmp( 関 数 ) 415 
strncmpi (関数 ) 416 
strncpy( 関 数 ) 417 
strnicmp( 関 数 ) 418 
strnset (関数 ) 419 
strpbrk( 関 数 ) 420 
strrchr( 関 数) 421 
strrev( 関 数 ) 421 
strset( 関 数 ) 422 
strspn( 関 数 ) 423 
strstr( 関 数 ) 424 
strtod( 関 数 ) 425 
strtok (関数 ) 427 
strtol( 関 数 ) 429 
strtoul( 関 数 ) 431 
strupr( 関 数) 432 
swab( 関 数 ) 433 
sys_errlist(( グ ロー バル 変数 ) 30 
sys_nerr( グ ロー バル 変数 ) 30 
sys\stat.h 12 
system( 関 数 ) 434 
sys 半 timeb.h 12 
sys\types.h 12 


【T】 


tan( 関 数 ) 435 
tanh( 関 数 ) 436 
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tell( 関 数 ) 437 
textattr( 関 数 ) 481.484 
textbackground( 関 数 ) 484 
textbank( 関 数 ) 488 
textblink (関数 ) 486 
textcolor( 関 数 ) 490.492 
textcursor( 関 数 ) 494 
textheight (関数 ) 625 
textmode( 関 数 ) 495,497 
textreverse( 関 数 ) 499 
textunder( 関 数 ) 500 
textvertial( 関 数 ) 501 
textwidth( 関 数 ) 626 
time( 関 数 ) 438 
time.h 12 
timezone (グロ ー バ ル 変 数 ) 38 
tmpfile( 関 数 ) 439 
tmpnam( 関 数 ) 440 
toascii( 関 数 ) 441 
tolower( 関 数 ) 443 
toupper( 関 数 ) 445 
TSR プロ グラ ム 247 
Turbo C の 言語 の 構文 

演算 子 782 

外部 定義 792 

キー ワー ド 776 

区 切子 782 

語 意 に 関す る 文法 777 

式 783 

識別 名 777 

定 言 783 

定数 777 

トー クン 776 
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プリ プロ セッ サ 指 令 775.793 
フレ ー ズ に 関す る 文法 775.781 


文 791 

文字 列 リ テラ ル 781 
tzname (グロ ー バ ル 変 数 ) 38 
tzset( 関 数 ) 449 


【U】 


ultoa( 関 数 ) 448 
ungetc( 関 数 ) 449 
ungetch( 関 数 ) 450 
unixtodos( 関 数 ) 451 
UNIX 形式 へ の 変換 112 
unlink( 関 数 ) 452 
unlock( 関 数 ) 453 


【V】 

values.h 12 

Va.…( 関 数 ) 454 
vfprintf( 関 数 ) 459 
vfscanf (関数 ) 462 
vprintf( 関 数 ) 457 
Yscanf (関数 ) 460 
vsprintf (関数 ) 461 
vsscanf (関数 ) 462 


【W】 


wherex (関数) 502 
wherey (関数 ) 503 
WILDARGS.OBJ 23 
window (関数 ) 504 


【X】 


x ア スペ クト 因子 527 
x 座 標 556 
ー の 最大 値 546 


索引 


【Y】 


y ア スペ クト 因子 527 
y 座 標 557 
ー の 最大 値 547 


【Z】 


Zentohan (関数 ) 750 


【 あ ぁ 】 


アー クコ サイ ン 50 
アー クサ イン 54 
ゲー クメン ジェ ング 下 67 
アク セス 
ー フ ラグ 384 
モー ド ' 399 
ー の 変更 78.79 
読み 出し / 書 き 込み 
48.79.98.99.178.291,292、400 
アク ティ プペ ー ジ 594 
アス ペク ト 比 527,597 


補正 因子 597 
アド レス 
__emit に 渡す 116 


余り 110.153.250 
一 時 停止 (実行 の -) 107.383 
色 
テキ スト バッ ク グ ラウ ンド 色 の 
設定 484.481.486 
文字 の 一 の 設定 484.481.492.490 
イン クル ー ド ファ イル 11 
イン ター バル タイ マ の 制御 661.664 
ウィ ンド ウ 
テキ スト モー ドー の 定義 504 
英 句 読点 ・ カ ナ 句 読点 を する 717 


索引 


英 数 字 ・ カ ナ 文 字 を 判定 する 713 
英文 字 ・ カ ナ 文 字 を 判定 する 713 
エコ ー( 画 面 へ の 一 ) 189 
エラ ー 
拡張 DOS 情報 111 
ー コ ー ド 30 
グラ フィ ックス を 返す 563 
ニー モニ ッ ク 11.31.32 
コマ ンド ライ ン 751 
スト リー ム 上 の ーー の 検出 140 
致命 的 な ー(Fatal) 752 
ディ スク アク セス ー 751 
ーー メッ セー ジ 30.753-768 
グラ フィ ックス ー を 返す 559,563 
コン バイ ラ 751 
シス テム ー 299 
致命 的 な 752 
ー へ の ポイ ンタ を 返す 409,410 
メモ リア クセ ス 751 
read/write 140 
エラ ー ハ ンド ラ 
ハー ドウ ェ ア ー 213.216 
浮動 小数 点 一 268 
ユー ザ が 変更 で きる 数 学 一 270 
演算 子 782 
演奏 状況 を 調べ る 697 
演奏 する 700 
演奏 の 再開 694 
演奏 の 中 断 707 
演奏 モー ド の 切り 換 695 
扇形 583 
椿 円 の 593 
オフ セット (far ポイ ンタ の ) 160,283 
親 プ ロ セ ス 120,390 
音色 デー タ の 設定 / 読 み 出し 691 
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音色 デー タバ ンク の 再 設定 704 


【 か 】 
カー ソル (テキ スト ウィ ンド ウ 中 の 一) 
ー 位 置 を 返す 502.503 
ー を 位置 づけ る 474 
カー ソル 属性 の セッ ト 494 
開始 点 (乱数 発生 の 一 ) 397 
外部 定義 792 
回 復 ( 画 面 の ー) 480 
書き 込み アク セス 48.79.98.101. 
178.292.,400 
書き 込み エラ ー 140 
拡張 エラ ー 情 報 111 
仮数 部 172 
下線 属性 の セッ ト 499 
可能 に する (割り 込み ) 118 
可 搬性 42 
可変 引数 リス ト list 454 
画面 
1/O -1/O 95.318 
座標 の 最大 値 546,547 
ー 上 の テキ スト の セー プ 480 
ー の 回 復 592 
ー の クリ ア 467.607 
ー へ の エコ ー 189 
ー モ ー ド の 回 復 592 
画面 ペー ジ の 切り 換え 488 
カジ ヴー 
ドロ ウー 529,.558.583.588.593 
ー の 設定 600 
ー の 最大 値 545 
background 528.558 
ー の 設定 598 
フィ ル 508.509.522.524.583.593 
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ー の 情報 を 返す 533 
ー の 設定 603 
カラ ー テ ー ブ ル (パレ ッ ト ) 595.,611 
環境 
DOS 一 
ー か ら デ ー タ を 返す 198 
ー ヘ へ デー タ を 追加 する 320 
ー 変 数 29 
COMSPEC 434 
PATH 121.391 
漢字 オプ ショ ン ( コ マン ドラ イン ) 709 
漢字 第 1 バイ ト を 判定 する 715 
漢字 第 2 バイ ト を 判定 する 715 
jisalpha(isaplha) 720 
jisdigit(isdigit) 720 
jislower(islower) 727 
jisspace(isspace) 727 
jisupper(isupper) 729 
jstrlen (strlen) 734 
jstrmatch (strpbrk) 735 
jstrncat (strncat) 736 
jstrncmp(strncmp) 737 
jstrncpy (strncpy) 738 
jstrrchr (strrchr) 739 
jstrrev (strrev) 740 
jstrstr (strstr) 742 
jstrtok(strtok) 742 
キー スト ロー ク の チェ ッ ク 246 
キー ポー ドイ ンタ ー フ ェ ー ス 646 
キー ポー ド 操 作 681 
左 似 乱数 327 
輝度 
高 一 475 
低 一 477 


索引 


標準 一 479 
逆 正弦 54 
逆 正 接 57 
逆 余弦 50 
キャ リー フラ グ 221.223.224.226 
行 
空白 の 挿入 476 
ー の 削除 468 
行末 まで クリ ア 466 
許可 (アク セス ー) 79.400 
禁止 する (割り 込み ) 109 
クイ ッ ク ソ ー ト アル ゴリ ズム 323 
区 切子 782 
国 別 デー タ 92 
ググ タイ ッッ 必 以 
ー1/O 594.622 
ー ア ダ プ タ 514 
バッ ファ 
内 部 バッ ファ 605 
ー エ ラー コー ド を 返す 563 
ー エ ラー メッ セー ジ 563 
ー 画 面 の クリ ア 511 
ジス テム 
ー の クロ ー ズ 513 
ー の 初期 化 566 
ー 情 報 を 返す 553 
テキ スト フォ ント 558 
デフ ォ ル ト の 設定 558 
ー ド ライ バ 514.566 
ニコ ー ド 589 
ー フ ァイル 566 
ー モ ー ド の 男 囲 549 
メモ リ 
ー の 解放 560 
ー の 割り 当て 562 


索引 


モー ド 514.566.592.607 
画面 操作 モー ド も 参照 
カレ ント ー を 返す 535 
ー の 名 前 548 
ー ル ー チ ン 14 
クリ ア 
画面 467 
行末 まで 466 
グリ ニッ ジ 標 準 時 38.108、180.211.446 
グロ ー バ ル 時 刻 変数 の セッ ト 446 
グロ ー バ ル 変 数 26 
_8087 26 
_argc 27 
_argV 27 
daylight 28 
directyideo 28 
_doserrno 30 
environ 29 
errno 30 
_fmode 33 
_heaplen 34 
_osmajor 36 
_osminor 36 
_psp 36 
_stklen 37 
syS_errlist 30 
syS_nerr 30 
timezone 38 
tzname 38 
_version 39 
警告 769-774 
現在 位置 (グラ フィ ックス ) 556.557,558, 
576.577.578.592.617.622 
ー の 移動 579.580 
検索 キー 261 
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検出 
グラ フィ ックス アダ プ タ 514,.566 
スト リー ム 上 の エラ ー 140 
高 郊 度 475 
ー ビ ッ ト の セッ ト 475 
構文 (書式 ) 
エラ ー 751 
コサイン 90 
ハイ バ ポ リック ー 91 
子 プ ロ セ ス 120,390 
コ プ ロ セッ サ (8087/80287) 
浮動 小数 点 で の 問題 点 161 
コマ ンド ライ ン 
エラ ー 751 
コル ー チ ン 257,364 
コン ソー ル 1/O 103.188,189 
コン トロ ー ル プレ ー ク 
リタ ー ン 186 
設定 359 
ハン ドラ 105 
割り 込み 216 
コン パイ ラ 
診断 メッ セー ジ 751 
サー ド パ バー ティ 提供 の 
デバ イス ドラ イ バ 572 


【 さ 】 


サイ ズ 
パレ ッ ト ー を 返す 551 
ファ イル ー の 変換 81 
文字 の 一 617 
最大 値 (カラ ー 値 の ) 540 
再 割 り 当て (メモ リ の -) 
ヒー プ 334 
far ヒー プ 133 
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サイ ン 381 
ハイ パ ポ リッ クー 382 
サウ ンド LSI 内 の レジ スタ 操作 702 
が ウン ドラ イザ プラ リ 
作業 ディ レク トリ 121.391 
ー の 変更 77.78 
て を 返す 190.191 
削除 
行 468 
ファ イル 452 
座標 
arc で の 一 を 返す 526 
画面 一 の 最大 値 546.547 
サフ ィ ッ クス (接頭 辞 ) 
exec.… 120 
Spawn.… 390 
シー ケン シャ ルレ コー ド 251 
終了 コー ド 43 
終了 時 関数 59 
終了 ステ ー タ ス 125.247 
時 間 
ー の 計算 84.108 
ー を 返す 84.438 
経過 一 
シス テム 時 刻 52.104,112,180, 
211.252.451.662 
ー を 返す 206 
ー を セッ ト す る 368.402 
ファ イル 時 刻 202.363 
式 780 
識別 名 775 
シグ ナル ハン ドラ 325,374-379 
ツラ ドウ ェ ザ ー 325 
ユー ザ 定 義 の 一 374 
指数 172 


索引 


指数 関数 126 
シス テム 
ー 時 刻 52.104.112.180. 
211.252.451.662 
ー を 返す 206 
ー を セッ ト す る 368.402 
ー 日 付 52.104,112.180. 
211.252.451.662 
ー を 返す 193 
ー を セッ ト す る 360.402 
シス テム 情報 を 得る 641 
シス テム 日 付 時 刻 の 読み 出し と 設定 662 
自然 対数 255 
実行 環境 の 初期 化 
(サウ ンド ライ ブラ リ ) 696 
実行 の 一 時 停止 107.383 
自動 検出 566.572 
シフ ト JIS コー ド 中 の 
漢字 以外 の 文字 を 判定 する 724 
シフ ト JIS コー ド を 
JIS コー ド に 変換 する 730 
斜 辺 475 
終了 
ー 時 関数 59 
プロ グラ ム の ー 124.125 
商 110 
乗 
10 の p 乗 304 
x の y 乗 303 
剰余 153 
常用 対数 255 
除算 (整数 ) 110 
long 250 
書式 設定 94.103.162.173.305.342.343. 
395.398.458.459.460.461.462.463 


索引 


型 指定 文字 345 
精度 指定 子 306-311 
代入 抑制 文字 344.349,350 
入力 サイ ズ 修 飾 子 305-316 
幅 指定 子 311.344.349.350 
引数 型 修飾 子 344 
フラ グ 文 字 306,309 
変 替 形 式 310 
変換 指定 文字 307.308 
変換 で き な い 文字 350 
ポイ ンタ サイ ズ 指 定子 344.349 
書式 文字 列 94.103.162.173.305.342.343. 
395 .398.458.459.460.461.462.463 
償 例 346 
探索 集合 347 
入力 フィ ー ル ド 346 
範囲 機能 348 
シリ アル 1/O 629.672 
診断 メッ モー ジ ( コ ン バ イ ラ ) 
数 学 エ ラー ハン ドラ 
(ユー ザ が 変更 可能 な 一 ) 270 
数 学 パ ッ ケ ー ジ (浮動 小数 点 ) 161 
スタ イル (フィ ル ) 558 
スタ ッ ク 73.89.226 
ー の 長き 37 
ー ポ イン タ pointer 257,364 
ステ ー タ スバ イト 637,677 
ステ ー タ スピ ビット 629.673 
スケ テー ダネ ター ド 
8087/80287 82.401 
浮動 小数 点 82.401 
スト ッ プ ビッ ト 629.673 
スト リー ム 
ー1/O 134.139,158.162,164 .166.167. 
173.182.185.188.205.210.305. 
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317.319,321.322.342.357,369, 
457.458.459,462 
入力 ー へ 文字 を 
プッ シュ バッ ク す る 395 
ー の オー プン 158,170 
ー の 置き 換え 170 
ー の クロ ー ズ 134.170 
ー の フラ ッシュ 140.152 
バッ ファ リン グ さ れ な い ー 3857.369 
バッ ファ リン グ さ れる - 357,369 
ファ イル ハン ドル を 結び つけ る 137 
スト ロー ク フ ォ ント 575.620 
リン ク さ れ た ー 591 
スピ ー カ (IBM PC の ) 288,389 
スペ ー ス 以外 の 半角 文字 を 判定 する 714 
図形 の フィ ル 524 
制御 ワー ド (浮動 小数 点 ) 87 
整数 
除算 110 
long 250 
スト リー ム か ら の 読み 込み 210 
スト リー ム か ら の 書き 込み 322 
変換 245 
正 接 435 
双曲線 一 436 
精度 (浮動 小数 点 ) 87 
セー プ ( 画 面 上 の ) テ キス ト の - 469 
セク タ ( デ ィ ス ク ) 45,46 
セグ メン ト 値 (far ポイ ンタ ) 163.283 
絶対 値 
1ong 整数 の 一 248 
整数 の 一 44 
複素 数 の 一 72 
浮動 小数 点 の 一 127 
設定 項目 メニ ュー 設定 項目 を 参照 
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全角 文字 
ー 大 文字 を 英 小文字 に 変換 する 746 
ー 英 大 文字 を 判定 する 729 
英 小文字 を 英 大 文字 に 変換 する 747 
ー 英 小文字 を 判定 する 727 
ー 英 文字 を 判定 する 720 
カタ カナ を ひら が な に 変換 する 743 
ー カ タカ ナ を 判定 する 722.723 
ー 名 読点 を 判定 する 724 
ー 数 字 を 判定 する 720 
ー ス ペー ス を 判定 する 727 
ひら が な を カタ カナ に 変換 する 
744,745 
ー ひ ら が な か を 判定 する 721 
ー 文 字 を 判定 する 729 
ー 文 字 を 半角 文字 に 変換 する 750 
宜 言 786 
線形 探索 251.261 
双曲線 正弦 382 
双曲線 正 接 436 
双曲線 余弦 91 
ソー スコ ー ド (ラン タイ ムラ イプ ラリ ー)10 
ソー ト ( ク イッ ク ) 323 
必 性 (テキ スト ) 481.484 
属性 ビッ ト 96.101.291 
属性 ワー ド 78.96.101 
ソフ トウ ェ ア 
ー シ グ ナル 325 
ー 割 り 込 み 184.221.223.228 
ー イ ンタ ー フ ェ ー ス 221.223,228 


【 た 】 


対数 
自然 一 255 
常用 一 256 


索引 


棒 円 521 
棒 円 紀 521 
格 円 の 扇形 593 
多角 形 519.523 
多項式 302 
タス ク の 状態 257 
維 線 必 性 の セッ ト 501 
探索 
DOS の PATH に よる ファ イル ー 
353 
ー ア ル ゴ リ ズム (DOS) 120 
線形 251.261 
バイ ナリ サー チ ( 二 分 探索 ) 70 
プ ブロック 中 の 文字 の 275 
文字 列 中 の 一 
トー クン ー 247.742 
文字 一 362.404.732 
探索 し て 追加 する 261 
タン ジェ ント 435 
ハイ パ ポ リッ クー 436 
チェ ッ ク 
カレ ント ドラ イ バ ベ 196 
キー スト ロー ク 246 
デバ イス タイ プ 235 
ファ イル エン ド 105.139,332 
致命 的 エラ ー 751 
ー メ ッ セ ー ジ 752 
チャ ン ネ ル 3 に 対す る モー ド 指 定 699 
長方形 588 
通貨 記号 93 
低 輝 度 477 
定数 777 
ディ スク 
BIOS に 送ら れる 操作 637.675 
ー1/O 637.643.675 


索引 


ー エ ラー 213 
アク セス 751 
書き 込み の べり ファ イ 209.373 
ー ス ペー ス を 直す 195 
ー セ クタ 45.46.637.675 
ー デ ィ レ クト リ の 探索 148.150 
ー ド ライ ブ の 設定 361 
ディ スク 装置 の 操作 637.643 
ディ スク 転送 アド レス 149.150,328 
ー の 設定 362 
ー を 返す 197 
ディ レク トリ 
ー の 削除 338 
ー の 作成 282 
作業 一 391 
ー の 変更 77 
ー を 返す 190.192 
ディ スク の 探索 148.150 
デー タ セ グ メ ント 34.73.89.266 
割り 当て 69 
ー の 変更 341 
デー タビ ッ ト 672 
テキ スト 
位置 合わ せ 617 
ー の 属性 481.484 
ー の コピ ー 
画面 上 の 長方形 領域 を 
他 の 場所 へ 478 
画面 へ 480 
メモ リ へ 469 
バッ ク グ ラウ ンド 色 481.484,486 
ーー フォン ト ( グ ラフ ィ ッ クス ) 558.617 
ー 情 報 を 返す 553 
モー ド 33.98,101,137.158.170.333. 
367.469.480.495.497.607. 
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画面 操作 モー ド も 参照 
ー ウ ィ ン ド ウ の 定義 504 
ー を 返す 472 
テキ スト 属性 
下線 属性 の セッ ト 500 
縦 線 属性 の セッ ト 501 
点滅 属性 の セッ ト 489 
反転 属性 の セッ ト 499 
デバ イス 
ー エ ラー 213 
型 チ ェ ッ ク 235 
キャ ラク ター 235 
ー チ ャ ネル 230 
ー ド ライ バ 
DOS- 230 
サー ドー ティ 提 供 の 一 572 
ー ド ライ バテ ー プ ブル 572 
デバ パッ ギン グマ クロ (assert) 55 
デフ ォ ル ト の 設定 558 
点滅 属性 の セッ ト 489 
動 的 メモ リ 割 り 当て 73.168,266,334 
トー クン 776 
文字 列 の の 探索 427,742 
ドラ イプ (カレ ント ーー 名) 196 
ドラ イブ 番号 531 
ドロ ウ カ ラー 529.558.583.588,593 
ー の 設定 359 
【 な 】 
内 部 グラ フィ ックス バッ ファ 605 
ニー モニ ッ ク ( エ ラー コー ド ) 11.30.32 
二分 探索 70 
日 本 語 対応 版 
jasctime(asctime) 718 


jctime (ctime) 719 
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入力 フィ ー ル ド 

スキ ャ ン さ れ な い - 351 

スキ ャ ン さ れる が 格納 され な い ー 351 
ノン ロー カル goto 257.364 


【 は 】 


フー 
2 次 元 一 508 
3 次 元 一 509 
ハー ドウ ェ ア 
エラ ー ハ ンド ラ 213.217 
ー 情 報 を 返す 679 
ー ポ ー ト 219.220.294 
ー 割 り 込み 118 
倍 長 整数 の 変換 265.448 
バイ ト 
入れ 替え 433 
コピ ー 286 
ハー ドウ ェ ア ポ ー ト か ら の 読み 込み 
220 
ハー ドウ ェ ア ポ ー ト へ の 書き 出し 295 
バイ ナリ サー チ 70 
バイ ナリ モー ド 33.98.137.158,170.367 
ハイ パ ボ リッ クタ ンジ ェ ン ト 436 
パケ ッ ト 構 造 体 
パス の 組み 立て 154 
バス の 分 割 156 
パス ワー ド 203 
パターン (フィ ルー) 508.509,522,524, 
558.583,593 
ー に 関す る 情報 を 返す 533 
ー の 設定 603 
ユー ザ 定 義 の 一 532.603 
バッ カス ・ ナ ウ ア 記法 775 
バッ ク グ ラウ ンド カラ ー 528.558 


索引 


ー の 設定 598 反転 属性 の セット 499 


バッ ファ ハン ドラ 374 
キー ボー ドー へ の エラ ーー 213.216.217.268.270 
文字 の プッ シュ バッ ク 450 シグ ナル ー 325.,374,379 
グラ フィ ックス 内 部 一 605 ユー ザー 定義 の 一 374 
出力 スト リー ム へ の 書き 出し 152 例外 一 82 
スト リー ムク ロー ズ 時 の 割り 込み ー 376 
ー の フラ ッシュ 134 ハン ドル 
ー の 解放 134 スト リー ム に 結び つけ る 137 
ー の クリ ア 152 ー の 複製 113.114 
バッ ファ リン グ ー を 返す 147 
スト リー ム 357.369 ハン ドル (ファ イル +ー) 
ファ イル 369 85.86.113.114,293 
バッ ファ リン グ さ れ な い ス トリ ー ム ヒー プ 89 
357.369 ー 上 の メモ リ 割 り 当 て 
バッ ファ リン グ さ れる スト リー ム 357.369 73.168.266.334 
パラ メー タデ ー タ の 設定 / 読 み 出し 705 ー の 長き 34 
パリ ティ 629.672 ー メ モリ ク グ の 解放 168 
パレ ッ ト 558.566.598.607 ー メ モリ の 再 割り 当て 334 
ー カ ラー テー ブル 595,598.611 ヒー プ (far) 
ー カ ラー の 変更 595.611 ー 上 の メモ リ 割 り 当 て 128.131 
ー サ イズ を 返す 551 ー 中 の 未 使用 メモ リ 129 
ー 情 報 を 返す 530.550 ー メ モリ の 解放 130 
ー 定 義 構造 体 530 ー メ モリ の 再 割 り 当 て 133 
デフ ォ ル トー 530 比較 関数 (ユー ザ 定 義 ) 323 
ユー ザ 定 義 の 一 ピク セル カラ ー 
IBM8514 615 ー の プロ ッ ト 587 
PC-9801 613 ー を 返す 552 
範囲 機能 348 日 付 
半角 文字 ー を 設定 する 360,402 
カナ 句読点 を 判定 する 716 シス テム の 52.104,112..180, 
カナ コー ド を 判定 する 714 211.252.451 
カナ 文字 を 判定 する 716 ー を 返す 193 
全角 文字 に 変換 する 712 ファ イル の 202.363 
ー を 判定 する 717 日 付 ・ 時 刻 の 変換 52.104.112.211.252,451 


索引 81Z 


ピタ ch 人 奉 メ ー ジ 
格納 の 必要 な メモ リ 565 
画面 へ の 書き 出し 585 
メモ リ へ の 保存 536 
ビッ ト の ロー テー ト 
long 型 整数 260 
符号 な し 整数 339.340 
ビッ トマ スク 177.399 
ビデ オ 情 報 ( チ キス トモ ー ド ) 472 
ビ ピュー ポー ト 
グラ フィ ックス 出力 用 に 一 を 設定 する 
622 
ー に 関す る 情報 を 返す 555 
ー へ 文字 列 を 表示 する 581.582 


標識 

エラ ーー 83 

ファ イル 終了 ー 83 
ファ イル 


1/0 85,142.145,162.164 166.167. 
173.182.332.333.357.457.460. 
463,556 

アク セス (読み 込み / 書 き 込み ) 
48.79.98.101,177.291.399 

アク セス 権 の 決定 48 

ー か ら の 読み 込み 332.333 

グラ フィ ックス ドラ イ バ ー 566 

更新 用 一 138.158.172 

ー コ ント ロー ルプ ロッ ク (FCB) 
328.329 

ー サ イズ 
ー の 変更 81 
ー を 返す 146 

ー 時 刻 202.363 

スク ラッ チ 439 

ー 属 性 78.79,96.291 
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ー 属 性 ビッ ト 96.101.291 
ー 属 性 ワー ド 78.96. 101 
ー に ファ イル ハン ドル を 
結び つけ る 137 
ー の 新た な 作成 96.98.100,101 
ー の 上 書き 98 
ー の オー プン 158、169.289,291 
ー の 置き 換え 170 
ー の 書き な お し 96,98 
ー の クロ ー ズ 85.134.135 
ー の 削除 335.452 
ー の 情報 を 返す 177.399 
ー の バッ ファ リン グ 369 
ー の 日 付 ・ 時 刻 202.363 
ー の 変換 33 
バイ ナリ ー 439 
ー ポ イン タ 
ー の 初期 化 337 
ー の セッ ト 176,291 
読み 込み / 書 き 込 み 263 
リセ ッ ト 174.333 
ー を 返す 144.179.437 


ー の 解析 296 
ユニ ー ク な ー を 作る 284.440 
ー を つく る 154 
ー の 変更 336 
ファ イル アク セス 許可 79.399 
ファ イル アロ ケー ショ ン テ ー ブ プル 200 
ファ イル エン ド を 調べ る 119.139.333 
ファ イル シェ ア 453 
ー 属 性 289 
ー の ロッ ク 254.453 
ファ イル ハン ドル 85,113,114.,291 
ー を 返す 147 


索引 


ー の 複製 113114 
ー を スト リー ム に 結び 付け る 137 
フィ ルカ ラー 508.509.523.524.583.600 
ー 情 報 を 返す 533 
ー の 設定 603 
フィ ル ( 図 形 の 一 ) 524 
フィ ルス タイ ル 558 
フィ ル バ パタ ー ン 508.509.523.524. 
558.583.600 
ー 情 報 を 返す 533 
定義 済み の 一 533 
ー の 設定 603 
ユー ザ 定 義 の 一 532.533.602.603 
フォ ント 
スト ロー クー 575,617.620 
ビッ トマ ッ プ ー- 617 
リン ク さ れ た ー 591 
肖 動 小数 点 
エラ ー 処 理 268 
ー 数 学 パ ッ ケ ー ジ 161 
ー ス テー タス 82 
ー 制 御 ワー ド 87 
ー の 変更 114.136.183 
ー 例 外 87 
浮動 小数 点 ス テー タス ワー ド 401 
タダ ジグ 
アク セス ー 385 
読み 込み / 書 き 込 み 384 
フラ ッシュ (スト リー ム の ~) 141 152 
プリ プロ セッ サ 指 令 541.552 
プリ ンク 指定 ビッ ト 481,484 
プリ ンタ 制御 関数 658.684 
プリ ンタ の 制御 658 
プレ ー ク タク 値 69.341 
フレ ー ズ の 構造 に 関す る 文法 775.780 


索引 


フレ ー ム ベー スポ イン タ 256,364 
プロ グラ ム セ グ メン ト プ レ フィ クス 

36.204 
プロ グラ ム の 終了 124.125 
プロ ッ ク 

コピ ー 274.277.279 287 

ー サ イズ の 調整 356 

far ヒー プ 上 の 133 
ヒー プ 上 の -~ 334 

ー 初 期 化 280.367 

ー 文 字 の 探索 275 
プロ ト タ イ プ 41 
文 551 
分 割 (パス 名 の ) 156 
文法 (TurboC の 構文 ) 775 
平方 根 396 
ペー ジ ( ア クティ プー) 594 
ペー ジ 番 号 ( ビ ジュ アル ー) 623 
8086 の 一 207.372 

ー の セッ ト 372 

ー を 返す 207 

ベク ター( 割 り 込 み -) 105 
ヘッ ダフ ァイル 41 


べり リフ ァ イ フ ラグ (ディ スク 書き 込み の 一 ) 


209.373 

変換 
ASCII 文字 へ 52,441 
double を 仮数 部 と 指数 部 に 172 
double を 整数 と 小数 点 以下 に 285 
long を 文字 列 に 265 
unsigned long を 文字 列 に 448 
大 文字 を 小文字 に 413,442.443 
小文字 を 大 文字 に 432.444.445, 

746.747 

ー 指 定 (printf) 305 
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整数 を 文字 列 に 265 
全角 文字 を 半角 文字 に 750 
半角 文字 を 全角 文字 に 712 
日 付 ・ 時 刻 52.104.718,719 
DOS 形式 へ 451 
UNIX 形式 へ 112 
グリ ニッ ジ 標 準 時 へ 211 
構造 体 へ 252 
党 動 小数 点 を 文字 列 に 115.136.183 
文字 列 の 一 
double へ 425 
long 型 整 数 へ 64,429 
unsigned long へ 429 
整数 へ 63 
浮動 小数 点 へ 61 
変換 モー ド 98.,99 
変数 
グロ ー バ ルー 26 
グロ ー バ ル 時 刻 の 一 446 
ポー ト 1/O 219.220.294,295,629.672 
ポー レー ト 629.672 
補正 因子 597 


【 ま 】 


マウ ス の 制御 650.653 
マシ ン 語 命令 を 
オプ ジェ クト コー ド へ 挿入 する 116 
丸め 
切り 上 げ 74 
切り 捨て 87 
丸め の モー ド (浮動 小数 点 ) 87 
未 使用 領域 を 返す (ディ スク の -) 195 
無限 大 (浮動 小数 点 ) 87 
メモ リ 
far ヒー プー の 再 割 り 当 て 133 
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ー ア クセ スエ ラー 751 
画面 領 寺 を て に コピ ー す る 180 
グラ フィ ックス ライ プラ リ で の 
ー 管 理 560.562 
指定 の ー ア ドレ ス 
ー か ら バ イト を 返す 298 
ー か ら ワ ー ド を 返す 297 
ー に 整数 を 格納 する 300 
ー に バイ ト を 格納 する 301 
ー の 解放 
DOS メモ リ 上 の 169 
far ヒー プ 上 の - 130 
グラ フィ ックス ー 560 
スモ ー ル ・ ミ ディ アム 
メモ リモ デル で の - 130 
ー の コビー 274.277,279.287 
スモ ー ル ・ ミ ディ アム 
メモ リモ デル で の - 286 
ー の 初期 化 280 
ヒー プー の 再 割り 当て 334 
ビッ トイ メー ジ を 一 に セー プ す る 536 
未 使用 の ー の 量 を 返す 89 
far ヒー プ 上 の 129 
ー モ デル 7 
ー 割 り 当 て 51 
far ヒー プ 128.,131 
グラ フィ ックス ー 562 
デー タ セ グ メ ント 69 
デー タ セ グ メ ント 上 の 
ー の 変更 341 
動 的 - 73.168,266.334 
ヒー プ 73.168.266.334 
モー ド 
アク セス ー 399 
ー の 変更 78,79 
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画面 モー ド の 回 復 592 
カレ ント グラフィック スー 535 
カレ ント ドラ イ バ で の 一 の 最大 値 545 
グラ フィ ックス ー 514.566,592.607 
グラ フィ ックス ドラ イ バ に お ける 
ー の 男 囲 549 
テキ スト ー 33.98.101.137.158,171, 
318.333.367.469.472.495.607 
て の 名 前 548 
バイ ナリ ー 
33.98.101.137 .158.170.367 
ファ イル 変換 98.101 
ヒコ 
色 の 指定 481.490 
大 文字 へ の 変換 444,445 
書き 出し 
stdout へ 165.319 
スク リー ン へ 318 
スト リー ム へ 162.,317 
拡大 (ユー ザ 定 義 ) 620 
キャ ラク タデ バイ ス 235 
小文字 へ の 変換 442.443 
ー サ イズ 617 
ー の 探索 
プ ブロック 中 275 
文字 列 中 404 
ー の 読み 込み 
stdin か ら 143.188 
コン ソー ル か ら 187 
スト リー ム か ら 142,185 
プッ シュ バッ ク 
キー ポー ド バ ッ ファ へ 450 
入力 スト リー ム へ 449 


文字 列 
ー1/O 75.95.143.165.205, 
294.295.321,395.398 
大 文字 に 変換 する 432 
逆順 に する 421 
小文字 へ の 変換 413 
ー の コビー 403.407,409,417 
ー の 初期 化 419.422 
ー の 高き を 返す 625 
ー の 探索 
トー クン 427,742 
文字 404.732 
ー の 追加 403.414 
ー の 長 さ の 計算 413 
ー の 幅 を 返す 626 
ー の バイ ト 数 を 調べ る 748 
ー の 比較 276.405,412.733,737 
文字 ケー ス の 無視 
278.406,412.416.418 
ー の 変換 61.63.64,425.429,431 
日 付 時 刻 一 104.719 
ー ポ イン タ を 移動 させ る 731 
ー リ テラ ル 781 
を し 一 を 調べ る 
最後 の 文字 421 
集合 中 に な い 文 字 408.741 
集合 中 の 文字 for 420 
集合 中 の 文字 か ら な る 部 分 423 
部 分 文字 列 424 
文字 列 1/O 461 
モノ クロ アダ プ タ で の 
グラ フィ ックス の 問題 点 505,583 


【 や 】 


文字 数 を 調べ る 710.734 


文字 カタ イプ を 調べ る 711.749 ユー ザ が 変更 で きる 
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数 学 エラ ー ハ ンド ラ 270 リン ク さ れ た フォ ント 591 


ユー ザ が ロー ド し た 例外 (浮動 小数 点 ) 87 
グラ フィ ックス ドラ イベ 589 例外 ハン ドラ (8087/80287) 82.401 
ユー ザ 指 定 の シグ ナル ハン ドラ 375 レジ スタ 変数 257.364 
ユー ザ 定 義 の 比較 関数 284.323 ロー テー ト (ビッ ト の っ ~) 
ユー ザ 定 義 の フィ ル パ タ ー ン 532.602.603 unsigned int 339.340 
ユー ザ 定 義文 字 の 設定 670 unsigned long 260 
余弦 90 ロッ ク ( フ ァイル シェ アリ ング ) 254.453 
双曲線 一 91 
読み 込み アク セス 【 わ 】 
48.79.98,101,178.291,400 ワー ド 
読み 出し ェ ラ ー 140 ハー ドウ ェ ア ポ ー ト か ら の 
読み 出し / 書 き 込み フラ グ 384 読み 込み 219 
内 ハー ドウ ェ ア ポ ー ト へ の 
【 ら 】 書き 込み 294 
ライ プラ リ ワイ ルド カー ド 
ー フ ァイル 7 ー の 展開 23 
ー リ ファ レン ス の サン プル 41 デフ ォ ル ト で を 行う 24 
ライ プラ リル ー チ ン 7 統合 環境 の 場合 24 
ライ ン 割り 当て (メモ リ の ~) 51 
2 点 間 に 一 を 引く 576 far ヒー プ 128,.130 
CP か ら 578 グラ フィ ックス メモ リ 562 
CP か ら 相 対 で 577 デー タ セ グ メ ント て で の -~ 69 
ー ス タイ ル 538.588.608 ー の 変更 341 
ー 幅 538.588,608 動 的 - 73.168.266,334 
ー パ ター ン 538 ヒー プ heap 73,168,266,334 
乱数 発生 ルー チン 327,330 割り 込み 
ー の 初期 化 331.397 ソフ トウ ェ ア ー 184,221,223,228 
ラン タイ ムラ イプ ラリ ハー ドウ ェ ア ー 118 
関数 の 分 類 13 ー を 可能 に する 118 
ー ジ ー ズ コー ドド 10 ー を 禁止 する 109 
ラン ダム な プロ ッ ク 書 き 出し 329 割り 込み 関数 (DOS) 207.372 
ラン ダム な プロ ッ ク 呼 び 出し 328 割り 込み の 制御 110.184 
ラン ダム レコ ー ド フィ ー ル ド 328.329 割り 込み ハン ドラ 376 
リン ク さ れ た グラ フィ ックス ドラ イベ 589 DOS- 213 
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割り 込み ベク タ 105 
8086 8086 の 一 207.372 
ー の 設定 372 
ー を 返す 207 


索引 823 
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